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QL scene 4 jam 


new London Quanta venue 


Fed up of DIGITAL PRECISION telling 
you how very good their software is? 


v "As you might surmise by this time, I am impressed by QMATHS's abilities. Having 
noted that DIGITAL PRECISION's advertising tends to be loaded with superlatives 


(incredible, ultimate, superb come to mind), I had approached this evaluation with 
some scepticism. That scepticism has vanished." > INTERNATIONAL QL 
REPORT (IQLR, available from Miracle Systems) May/June 1993 issue, Official Review 
by M.Laverne commissioned by IQLR (who bought their review copy of the program). 
J "PERFECTION is an exciting, full-flavoured, general purpose word processor of 
incredible capacity... PERFECTION has now been outshone by the recently released 
PERFECTION SPECIAL EDITION... The discoveries began to trip over themselves as 
PERFECTION SE responded to the keyboard with unexpected speed and 
intelligence... PERFECTION SE is blindingly fast at most things, and you are never 
left waiting for it. PERFECTION is everything that Quill never became: easy to use, 
very flexible, loaded with genuinely useful features, cleanly multi-tasking, capacious 
and incredibly fast. The SPECIAL EDITION offers 12 cylinder power and luxury to an 
already impressive package." > SINCLAIR QL WORLD magazine Official Review, 
vat 1993 issue, by THE Mike Lloyd of Keyword Index / New QL User Guide fame. 
"I find PROFESSIONAL PUBLISHER an outstandingly good program that really 
does allow highly professional documents to be produced. For your interest I have 
included a few samples of work done for school using a combination of PERFECTION, 
PROFESSIONAL PUBLISHER, QUICKLASER and EYE-Q. You will be pleased to 
know that the quality has been rated so highly that people do not believe it can really 
have been done with just a QL... I must stress that I am already highly impressed with, 
and very satisfied by, the performance of PROFESSIONAL PUBLISHER and all the 
other DP programs that I use... I seem to learn something new that can be done 
almost each time I use the program. Very many thanks for helping to keep the QL 
ahead of the field." > Martin J Neave, Headteacher, Watton County Jnr School, 
Brandon Rd, Watton, Norfolk, IP25 6AL (unsolicited letter dated 18 May 1993 
ogdering more programs: Mr Neave had paid full price for everything). 
‘i "LIGHTNING SPECIAL EDITION accelerates QL operation as nothing else does... 
more than 10x is achievable and 2x-4x is typical... I could not fault LIGHTNING 
SPECIAL EDITION on anything. It is a clear winner and a best buy at £49.95." > 
SINCLAIR QL WORLD magazine Official Review, April 1990 issue, by Ron Massey, 
who wrote EDITOR (bought full price) was "Superb" in an earlier review. 


"PERFECTION is well named" > R.H.Petford, Kingston Hill, Surrey, KT2 7LJ 
(unsolicited letter received May 25, 1993: another full price purchaser & upgrader). 


"When my ideal program finally arrived in the form of PROFESSIONAL 
PUBLISHER, it surpassed all my expectations... PROFESSIONAL PUBLISHER (is) in 
a class of its own, and makes it the only QL desktop publishing program for the very 
serious user... Until Digital Precision released PROFESSIONAL PUBLISHER, my 
opinion was that the use I could make of desktop publishing was mainly restricted to 
short documents... PROFESSIONAL PUBLISHER is a very versatile program... The 
illustrations for this series of articles have all been produced on PROFESSIONAL 
PUBLISHER... My printer is a BROTHER 9-pin dot matrix printer. It does illustrate 
the very high quality that can be obtained from PROFESSIONAL PUBLISHER even 
when using a simple printer." > SINCLAIR QL WORLD magazine Guide to desktop 
publishing ("A Question of Dots"), January 1992 to December 1992 issues: the 
reviewer had bought PROFESSIONAL PUBLISHER, PERFECTION SE, FONT 
E RGER, TOOLBOXES, QUICKLASER etc from Digital Precision all at full price. 

"Lam aware that over the years Digital Precision has given considerable support to 
the QL scene but seldom, if ever, can there have been such estimable service as I 
recently encountered with PERFECTION PLUS." > The Hon. W.D.R. Spens, 
Bridgewater, Somerset, TAS 1HG, QUANTA magazine, March 1992 issue. Mr 
Spens has bought a lot of his software from Digital Precision, all at full price of course. 
ince Digital Precision Desktop Publisher was rightly hailed as an extraordinary 
programming achievement when it was released two years ago. Mike Lloyd casts a 
professional eye over Digital Precision’s latest page-making blockbuster 
(PROFESSIONAL PUBLISHER) and finds plenty to be pleased about... there is 
unlikely to be a single program of such magnitude and quality (as PROFESSIONAL 
PUBLISHER) written for the Sinclair QL." > SINCLAIR QL WORLD Official 

view, August 1989 issue, by M.Lloyd, who personally bought all this at full price. 

"EDITOR is a liberation. After Quill, it was like jumping from an aquarium into the 
sea. It has become part of my professional life... Everyone is now writing about the 
excellence of PERFECTION. I have not tried it, not having any perceived need for it 
(having EDITOR)’ > Suzanne Cronje, QUANTA magazine, May 1992 issue, page 2. 

Cronje naturally had paid the full price for her copy of EDITOR SE etc. 

"| have found (PERFECTION) to be simply excellent, fast, packed with features 
and very well thought out. I can find little to say that will convey just how good this 
program is, except to quote Digital Precision’s own advertising: PERFECTION will 
blow your socks off. PERFECTION is the program that Quill users have been 
waiting for." > SINCLAIR QL WORLD’s first Official Review, May 1991 issue. 

"Digital Precision (DP) decided to begin work on a replacement for Quill which 
would be very quick, simple to use and contain lots of excellent features - something 
upon which DP have built a very strong reputation in the QL market... Overall, the 
speed-up (of just the first release of PERFECTION - it is much faster now) on even a 
humble QL with Trump Card is amazing when compared with Quill (or any other 
word processor). On top of this, the program. provides many excellent and well 
thought out features, each of which is easy to use... (it) is certainly years ahead of the 
competition on the QL (and even on many PCs)." > R.Mellor, c/o CGH Services, 
Cwm Gwen Hall, Pencader, Dyfed, SA39 9HA; Official Review of the very first 
version of PERFECTION in QL TECHNICAL REVIEW issue 7: and the reviewer 
personally bought his own copy of this program, and many others at full price, from 
Digital Precision. Earlier QLTR reviews pronounced LIGHTNING (just the standard 
[a superior to the competition and ADVENTURE CREATION TOOL excellent. 


"PERFECTION SE is superb!! With Gold Card, it puts life in the fast lane. Thanks." ” 


> Leonard Singleton, Bletchley, MK3 6BP, June 1993, a full price purchaser (=fpp). 


V "As a recent user of PERFECTION PLUS SE, may I add my thanks and praises to 
the ones I am sure you have already received... keep up the excellent work." > R 


Sjawson, East Molesey, Surrey, KT8 OBP(unsolicited letter from full price purchaser). 
"At about 360,000 words, the Mega SPELLCHECKER dictionary does not have 
much competition, on any computer! (Gpelichecking! is about four times as fast as the 
best figures I have seen with other checkers on QL and PC." > SINCLAIR QL 
WORLD magazine official review of PERFECTION spellchecker, September 1992 
issue, by Bryan Davies of Troubleshooter repute (review copies of all the competing 
pyoducts supplied to SINCLAIR QL WORLD by their respective publishers). 
v "In the past I have purchased a number of your programs and have never failed to 
be impressed by the quality of both product and documentation. (So) please send a list 
Nee current products." > V.Negri, Hempton, Norfolk, NR21 7LF, June 1993, fpp. 
"This is my first letter with PERFECTION SE. | must say I’m impressed with it and it 
is certainly fast. Hooray, goodbye to Archive!" > P.H.Heilbron, Reigate, RH2 ODJ, a 
full price purchaser now using PERFECTION to replace not only Quill but Archive too. 
"[ have been using PROFESSIONAL PUBLISHER for about eighteen months now... 
what you can do with it is colossal... I got Digital Precision’s QUICKLASER. The 
results are as good as (Digital Precision) says in its advertisements..." > P.Hamill, 
Peterborough, Cambs, PE8 6RH, QUANTA magazine, Volume 9 issues 4/12. Mr 
mill (full price purchaser) then makes suggestions to users re optimal page sizes. 
"Once again I would like to say thank you for your help. I would like to tell the 
world what nice guys you are but unfortunately I have no contact with the outside 
wprld." > J.Bailey, Godshill, Ventnor, PO38 3JJ (full price purchaser, 24 May 1993). 
‘i "PC CONQUEROR GOLD SPECIAL EDITION is an excellent product, 
accompanied, as so often with Digital Precision software, by a comprehensive and 
informative manual. The program does a difficult job, and does it well... Overall, this 
program is much faster, more compatible and capable..." > SINCLAIR QL WORLD 
icial Review, March 1993 issue, by M.Knight (bought many DP programs full price). 
"With printing of the quality that this page bears witness to, I am a very satisfied 
PERFECTION user. | hope that you continue to provide the software innovation and 
the accessible backup which is great. So, thank you very much again and may I wish 
ygu every good fortune." > P.Stewart, Temple, London, EC4Y 9BE, 10 May 1993, fpp. 
"Many thanks for the update of PERFECTION SPECIAL EDITION. I am suitably 
impressed. Congratulations on producing the only word processor that I know that 
offers the best of all worlds as far as formatting is concerned. After Quill, 
PERFECTION is like a breath of fresh air." > Geoff Wicks, 1097HL Amsterdam, 
Netherlands (unsolicited letter dated 13 June 1993: all software including LIGHTNING 
PERFECTION SE, PRO PUBLISHER, CONQUEROR SE etc. purchased at full price). 


"All | can say about QMATHS is: WOW!" > Robin Wyke-Holloway, Salisbury, SP5 
4WG (unsolicited letter received April 1993: Mr Holloway is a full price purchaser). 


"l have had PERFECTION from the early days and have had many hours pleasure 
finding out more and more of its brilliant features. May I offer my congratulations on 
such an easy to use program which does everything I want - and more besides." > 
eae Pinner, HA5 5AZ, fpp, thanking us for fixing a printer problem he’d had. 

"Having used a range of desktop publishers on the Atari ST & Amiga, I admit I am 
very impressed with the superior performance of PROFESSIONAL PUBLISHER. It 
contains everything required" > SINCLAIR QL WORLD January 1989 issue, article 
entitled "Six of the Best" which also praised five other new Digital Precision programs. 

"I find it difficult to express my gratitude for the speed of your response, and for 

the opportunity to see inside two excellent programs which I have long enjoyed using." 
>,Richard Walker, Enniskillen, BT74 7LG, full price purchaser and QL expert. 
V "May I take this opportunity to say that I have, in the past, found the software you 
have supplied me with (LIGHTNING etc.) to be of extremely high standard, on a par 
with that found in industry-standard PC packages. Keep up the good work. Without 
your quality software, 1 would be forced to abandon the QL and go to a PC." > G. 
Reynolds, Crosby, Liverpool, L23 OSS (unsolicited letter dated April 2 1993, placing a 
further order for DP software: all programs old & new were purchased at full price). 


This is but a casual selection, drawing only on extracts from recent letters and reviews. 
We could locate >1000 complimentary communications but we’d prefer to spend our time 
producing new programs! We refer potential customers (existing users of DP products already 
know how good they are) to pages 18/19 of the September 1988 issue of Sinclair QL World, 
which contained unsolicited quotations from happy Digital 
Precision customers, That collection covered only three programs (and that too only partly - we 
ran out of space) and predated the release of what many consider to be our best software 
(LIGHTNING SE, PERFECTION SE, PROFESSIONAL PUBLISHER, CONQUEROR SE etc). 
We reproduce those pages below, duly reduced to fit. If you want a readable copy, consult the 
relevant back issue or send us an SAE or ask for a full-sized copy while ordering from us... 
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So hear it from their customers! 


3—-D PRECISION CAD SYSTEM 


SPECIAL DEALS 


ADVENTURE CREATION TOOL SPECIAL EDITION 49.95 
5% off total if you buy 2 programs/upgrades; ECan DEVELOPMENT SYS + RUN-TIME MODULE 2995 
10% off 3; 15% off 4; 20% off 5; 25% off 6+ RIAL 19.95 


Upgrades cost difference in price + £10 
Non-UK Europe add 5%, rest of world 10% 


For full terms ond conditions, please refer to any of our QL World ads from Jan-Nov 1990, or write in including a SAE 


AME 
CASH TRADER v3.3 + ANALYSER 99.95 
COMPARE FILE UTILITY 19.95 
COPY UTILITY FOR BACKING UP 9.95 


CPORT BASIC TOC TRANSLATOR WITH C68K COMPILER 99.95 
CPORT IMPROVED VERSION 19.95 


APPOINTMENT DATABASE SYSTEM 19.95 
DESKJET/LASERJET DRIVER FOR PRO PUBLISHER 19.595 


A brand new CPORT system, enabling you to rapidly DESKTOP PUBLISHER SPECIAL EDITION 39.95 


convert your SuperBASIC programs into C (ANSI or 
Lattice). The new (October 1992) version is now as 
close to being fully automatic as makes no difference 
— you must get it! 


DISKTOOL WITH QUICKDISK 19.95 
DROIDZONE GAME 9.95 
DR-DOS v6.0 STATE OF THE ART PC OPERATING SYSTEM 79.098 


EDITOR SPECIAL EDITION 49.95 
Owners of our earlier CPORT versions should return disk + SAE for a free upgrade. EDITOR 29 95 


EYE-Q GRAPHICS SYSTEM 
FONT ENLARGER 


19.95 
SUPERFORTH COMPILER WITH REVERSI GRAFIX o4 PIN UNIVERSAL, PRINTER DRIVER 74°98 


HARDBACK + FINDER HARD DISK MANAGER 49.95 
IDIS INTELLIGENT DISASSEMBLER 24.95 
IDIS SPECIAL EDITION 39:95 
LIGHTNING ACCELERATOR 24.95 
LIGHTNING SPECIAL EDITION ACCELERATOR 49.95 
LIGHTNING SPECIAL EDITION FOR GOLD CARD 39.95 
MAILMERGE DATABASE SYSTEM 19.95 
MEDIA MANAGER SPECIAL EDITION 49.95 
MEDIA MANAGER 24.95 
MEGA DICTIONARY 29.95 
MICROBRIDGE 39.95 
NAMES AND ADDRESSES DATABASE SYSTEM 19.95 
PAYROLL SYSTEM 49.95 
PC CONQUEROR GOLD SPECIAL EDITION WITH DR-DOS v6.0 179.95 
PC IR GOLD SPECIAL EDITION 99.95 
AS CON ae WITH DR-DOS v6.0 

PEDIT PRINTER DRIVER FOR XCHANGE 19.95 
PERFECTION PLUS SPECIAL EDITION WITH SPELLCHECKER 139.95 
PERFECTION PLUS WITH SPELLCHECKER 99.95 


Forth is the most logical computer language. This compiler produces multitasking code. 
The manual teaches you Forth-83 from scratch. 


IDIS SPECIAL EDITION 
IDIS 


These intelligent disassemblers make the otherwise terrifyingly complex task of 
understanding other people's machine code programs absurdly easy. The SE version, 
which has a higher hardware requirement, sorts out some routines, replaces addresses 
with names, untangles data from code and much more. 


QKICK FRONT END SYSTEM 


This is a simple, easy-to-master, pull-down menu controlled multitasking front end. QKick PERFECTION SPECIAL EDITION WORD PROCESSOR 99.95 
runs In the background and can be called up at any time. It provides you with notepads, , 39-95 
sophisticated file/sector/RAM handling, backing up facilities, a clock, diary, calculator, 29.95 
mini-database and so on. 69.95 

PROFESSIONAL ASTROLOGER 59595 


PROFESSIONAL ASTRONOMER 29°95 
PROFESSIONAL PUBLISHER TOOLBOXES (PARTS ONE & TWO) 49.95 
PROFESSIONAL PUBLISHER TOOLBOX PART ONE 29.95 
PROFESSIONAL PUBLISHER TOOLBOX PART TWO 29.95 
PROFESSIONAL PUBLISHER 89.95 
FLICK CARD INDEX SYSTEM 29.95 
ICK FRONT END SYSTEM 24.95 
THS MATHEMATICAL SYSTEM PART ad 69.95 
THS MATHEMATICAL SYSTEM PART TWO 59°95 
THS MATHEMATICAL SYSTEM Eas ONE & TWO) 99.595 
MACHINE CODE MONITOR v 39.95 

VER ARCHIVE UTILITY 19.95 


ADVENTURE CREATION TOOL SPECIAL EDITION 


ACT is a must for every programmer. The name of the program is misleading, insofar as it 
has capabilities far beyond the 'mere' creation of adventures. ACT has utilities providing 
animated graphics, data compression, language design, parsing, maps, object-oriented 
control etc. If all you want to do is generate adventures, though, you do not need to be 
a programmer to use it. This is a purchase you will never regret. 


REVERSI GAME 9.95 

SEDIT + SCREENPRINT ARCHIVE UTILITIES 49.95 

SOLUTION PC EMULATOR WITH DR-DOS v6.0 109.95 

/ SOLUTION PC EMULATOR 29.95 

A fast, modern and capable printer driver for the programs bundled with the QL. SPELLCHECKER WITH DICTIONARIES 49.95 
EMULATOR 49.95 

24.95 

39.95 

MICROBRIDGE ce 

Superb contract bridge bidder (ACOL etc) and player, using millions of random but aaa 
reconstructable hands. Microbridge also includes a state of the art Interactive bidding T LTT 29.95 
tutor and a clear instruction manual. There is nothing like this anywhere else! TRANSFER UTILITY SPECIAL EDITION 29195 


TRANSFER UTILITY 91.95 
TURBO BASIC COMPILER + TOOLKIT 79.95 
ULTRAPRINT SCREEN DUMP UTILITY 19.95 
XREF SUPERBASIC PROGRAM ANALYSER 29.95 
KEY>)>>>>>> Available either on cartridge or disk 
Available only on disk 

Minimum 512K exp:only available on disk 
Minimum 256K exp:either cartridge or disk 
Minimum 256K exp:only available on disk 
Available only on cartridge 

Minimum 1.5Mb RAM:only available on disk 

As well as cartridge or disk, you get a ROM 


SUPER ASTROLOGER 


A very cut-down version of Professional Astrologer — still great fun, though! 


SUCCESS CP/M EMULATOR 


Allows your QL to run CP/M programs at great speed. 
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Send to: DIGITAL PRECISION LTD, 222 THE AVENUE, CHINGFORD, LONDON E4 9SE or phone 081-527 5493 
Please rush me: 
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Card No: Expiry: Signed: in ae S ae 


Delete as appropriate: (QUTHOR/STQL)(MDV/3.5"/5.25")(Disk=360/720/1440/2880/6400 sectors; nb 1 sector=0.5K)(If 720 sectors: SSDD/DSSD) 


MIRACLE SYSTEMS 


16MHZ 68000 : 
HIGH SPEED 2M BYTE 
PROCESSOR RAM 
DD, HD, ED, CUSTOM 
DISK 2. LOGIC 
INTERFACE . CHIE: 
~~ 2 BATTERY 
_. BACKED 
CLOCK 


QL GOLD CARD 


£225 inc. (£200 outside EC) 


This is the expansion that has been revolutionising the QL. It is very easy to fit - 
it simply plugs into the expansion port at the left hand of the QL - and once fitted 
it will instantly increase the execution speed of the QL by about 4 times due to 
the presence of a 16MHz 68000 on board. There is 2M of fast 16 bit RAM of 
which QDOS sees a contiguous 1920K. The remainder is used for shadowing 
the QL’s ROM and display memory and for the GOLD CARD's own code 


There is a disk interface which can access 3 mechanisms (4 with the DISK 
ADAPTER) of 3 different densities, DD (double density, 720K), HD (high density, 
1.44M) and ED (extra high density, 3.2M) in any mix. The disk interface 
connector is the same type that was fitted to the TRUMP CARD so most QL 
compatible disk drives can be used. Please note that DD drives still give a 
capacity of 720K per diskette. Our DUAL ED DISK DRIVE allows the GOLD 
CARD to access DD, HD and ED diskettes. 


Another feature is the battery backed clock. When the QL is switched on the 
contents of the clock are copied into the QL's clock so that the time and date are 
correct. The firmware in the ROM gives the GOLD CARD all the functionality of 
the TRUMP CARD like TOOLKIT II and there is a sub-directory system for 
floppy and RAM disks. 


Physically the GOLD CARD is about half the size of the TRUMP CARD and so 

fits almost all within the QL. Its current consumption is well under the allowable 

maximum so no special power supply is required. The GOLD CARD comes with 
a 14 day money back guarantee and a 2 year warranty. 


See us here: 


Sunday 23rd January 1993 
Georgian House Hotel 
Blackrod 
nr. Manchester 


Saturday 12th February 1993 
Scottish Workshop 
Edingburgh 
For venue details contact Alan Pemberton, 
68 Lingerwood Road, Newtongrange, 
Midlothian EH22 4QQ 


Tel: (0904) 423986 


To place an order by phone 

please have your credit card 

ready. For overseas customers 

we charge the prices shown in 
’ brackets. 


the form opposite or write to 
us quoting your credit card 
number and expiry date, or 


Please send me 


THE QXL 


— 


The QXL turns the common PC into a QL compatible. The package comprises a half 
card that plugs into an 8 or 16 bit standard ISA slot and a diskette loaded with a QDOS 
compatible operating system and a Superbasic compatible interpreter. After installation 

simply type QXL and the PC will appear to be a QL allowing QL programs to be run from 
QL format diskettes. 


The card itself has a 32 bit 68EC040 processor running at 20MHz which gives a good 
turn of speed. This processor has access to its own RAM and so performance is virtually 
independent of the host PC whether it has an 8088 or a Pentium. In fact the PC is used 
purely as an I/O system giving QL programs access to the PC's floppy disc, hard disc, 
keyboard, display, serial and parallel ports. The card itself has QL style network ports to 
allow connection to a QL network. The minimum PC specification required is an XT with 
EGA display and a spare standard slot. 


Varying RAM sizes from 1M up to 8M can be supplied. The smaller capacities can be 
upgraded to the larger ones and the cost is simply the price difference. Not all the RAM 
is available to the user programs; the 1M equates roughly with a TRUMP CARD QL 
memory size and the 2M with a GOLD CARD QL. 


During the lifetime of the QXL we intend to enhance the software to make use of the new 
hardware facilities of the PC such as SVGA graphics. As has been our policy with the 
TRUMP CARD and GOLD CARD we intend to provide software upgrades free of charge. 


QXL prices 


IM £295 (£255) 
2M £325 (£280) 
5M £410 (£355) 
8M £495 (£430) 


(prices in brackets for outside EC) 


INTERNATIONAL QL REPORT (IQLR) is a regular magazine that all QL 
users should read. It has articles for the beginner, the advanced user and 
every one else in between. Also, the international flavour combined with 
low advertising rates makes it probably the best place to locate QL related 
items. IQLR is run by QL enthusiasts whose proud boast is that they have 
never been late with an issue. If you do not already get it then ‘phone us 
now. One year’s subscription for 6 issues to any European address is 

£22.00 and it’s worth every penny. Subscribers 
elsewhere should contact SeaCoast Services, 
15 Kilburn Court, Newport, RI 02840, U.S.A. direct. od} 


To: MIRACLE SYSTEMS Lid, 25 Broughton Way, 
Osbaldwick, York, YO1 3BG, U.K. Tel: (0904) 423986 


| enclose a cheque to the value of: £ 


Expires 


| LILI 
/ 


Signature 


enclosing a cheque payable to 


MIRACLE SYSTEMS Ltd. Address 


r 
I 
I 
I 
I 
| 
| 
1 
I 
1 
I 

To order by post, please fill in : Or debit credit card 
1 
| 
I 
I 
| 
| 
1 
1 
| 
I 
I 
| 
1 
I 
1 


Helen Armstrong 


Publisher 
Mark Kasprowicz 


Advertising Manager 
Jim Peskett 


Creative Director 
John Stanley 


Graphic Artist 
Steve Billington 


Magazine Services 
Linda Miller, 

Frances Maxwell, 
Pauline Wakeling, 

Val Brandon 


Sinclalr QL World, 
Published by Arcwind Ltd. 
The Blue Barn, 

Tew Lane, Wootton, 
Woodstock, 

Oxon. OX7 1HA 

Tel: 0993 811181 

Fax: 0993 811481 

ISSN 026806X 


If you have any comments or 
difficulties please write to the 
editor and we will do our best 
to deal with your problem in 
the magazine, though we 
cannot guarantee individual 
replies. 

Back issues are available 
from the publisher price £2.50 

UK, £2.99 Europe. Overseas 
rates on request. 


Subscriptions from: Arcwind 
The Blue Barn, Tew Lane, 
Wootton, Woodstock, Oxon. 
OX7 1HA 

UK: £23.40 

Europe: £32.90 

Rest of World: £40.90 


Reprographic Services: 
Eclipse, Brook Street, 

| Watlington, Oxon. OX9 5JH. 
Distributed by: Seymour Press 
Ltd., Windsor House, 1270 
London Road, Norbury, 
London, SW16 4DH 


© 1993 ARCWIND LTD. 

Sinclair QL World is published 12 
times a year. All rights reserved. 
Reproduction in whole or in part 
without written permission is 
strictly prohibited. We welcome 
contributions. All material must be 
supplied with a SAE. 


While all reasonable care is taken 
in compiling QLWorld, the 
publisher and its agents assume 
no responsibiity in affects arising 
therefrom..Opinions expressed 
are those of the ‘authors. 


6 TROUBLESHOOTER 
Bryan Davies looks at the LineDesign updates, and the Psion 3. 
8 OPEN CHANNEL 


Other languages ... community help .. stuck with cursor colour ... naval lead ... blind 
need computer help ... family tree search .. dates again! 


10 QL SCENE 


London Quanta new venue .. New front end from Hessler ... Miracle latest .. QL Prolog 
» Ergon simplifies pricing! ... French AGM. 


11 SUPERBASIC IN ACTION 
Simon Goodwin code-caches with the new Motorola chips 
15 THE NEW USER GUIDE - part 29 and 30 
The Keyword Index from WHEN to WINDOWS... and the introduction to CONCEPTS. 
19 DIY TOOLKIT 
Simon Goodwin serially interrupts mice with assembler. 
23 NEURAL NETWORKING 
Dr. Steven Wilcox brings the latest in artificial intellgence to the QL 
28 REVIEW: PROPUB TOOLBOXES 
Bryan Davies looks at DP’s ProPub add-on software. 


31 MICRO ADS 


Coming Soon 


A map of the WORLD .. QL CALENDAR .. the Fifth Italian SHOW. 


Bryan 
Davies looks 
at some 
updates, the 
Psion 3, and 
an unwell 
Thor. 


In issue II.9, 
Dilwyn Jones gave 
some advice on 
the use of the 
SERMouse serial 
mouse kit - that 
you need to be 
careful not to hold 
down a mouse 
button when 
switching on the 
QL This applies to 
3-button mice 
which do not have 
a mouse-mode 
switch on them. 
There may be 
other variations on 
this theme, 
though. When 
used on a PC, my 
own Genius GM6 
mouse defaults to Mouse Systems 
mode (3-button) and will only oper- 
ate as a Microsoft Mouse (2-button) 
if (any) one of the three buttons is 
held down during the boot process. 
This caused sufficient annoyance 
to push me into buying another 
mouse, which has the 
Microsoft/Mouse Systems switch 
on it. 

The same issue has a letter from 
Ron Stewart, suggesting a fix for a 
problem which can occur with the 
Abacus Amend commana. This fix 
was demonstrated at our last local 
Quanta group meeting, and it cer- 
tainly seemed to work. There is no 
guarantee that making the patch 
he gives will not cause some other 
trouble, but it is definitely worth try- 
ing. 


amIOOreH 


File Finder 


In my review of File Finder (“FiFi’) 


some months ago, | commented that 
a text string could not be located in a 
file created in Professional Publisher. 
The program writer replied that the 
reason for this is that the text was not 
in the file as text, but as bit-mapped 
images. This brings up a point that 
could trouble average users - when is 
text not text? My own pi 
of how text is contained in DTP ( 


high-end WP) program files is condi- 
tioned by experience with other pro- 
grams, in which text does remain as 
“itself? 

Programmers obviously see files dif- 
ferently from the way users see them; 
one looks at the file as a structure, the 
other sees it as an end-product some- 
thing that is readable as normal lan- 
guage on a piece of paper. In writing 
reviews, | look at programs as a user. 
What goes on internally, within a file, 
does not normally interest me. It is 
only when something goes wrong 
with a file that its internals need to be 
investigated. 


LineDesign 


Very soon after the initial release, 
Belgian software developers Progs 
have started supplying beta-test 
copies of version 2.00 of LineDesign 
for comment. As they promised earlier, 
they are working hard to improve 
areas of the program which fell short 
of the general program standard. They 
have not wasted any time bringing 
out important changes. 

The open way in which Progs speak 
of the difficulties of getting certain pro- 
gram functions to work acceptably will 
appeal to many users. Making the 
problems clear, and assuring users 
(and potential buyers) that fixes are in- 
hand, should reassure people for 
whom the program is a substantial 
investment. We have all suffered from 
programs which have not been suffi- 
ciently de-bugged before release, but 
we have rarely been given any infor- 
mation on what the programmers are 
doing to make their masterpieces 
usable. 

In this case, we even have printed 
instructions “especially for the beta- 
testers”! The first thing that is apparent 
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when 2.00 is fired up is that it is 
appreciably faster than 1.08 as 
reviewed in II.9. All aspects seem to 
have benefitted. Loading documents 
for the review, another improvement 
became obvious - if a fount specified 
in the file being loaded is not current- 
ly available, you can select another 
from a drop-down list. Zooming into 
the displayed page is a simple 
process and quick with an average 
type of page. The maximum size to 
which the selected portion of the 
page can be blown up should satisfy 
most users. What will please anyone 
who has used bit-map editor pro- 
grams is the unchanging nature of 
the images as they are magnified: 
lines are not all absolutely straight, of 
course, but the image looks much 
the same whatever size it is dis- 
played at. 

Conventional scroll bars have 
replaced the toolbar arrows. A feature 
which has not yet been implemented 
is Insert Bitmap. This will allow QL 4- 
and 8-colour screen dumps to be 
inserted in current LineDesign pages. 
It is intended that other (non-QL?) for- 
mats will be supported by this com- 
mand in the future. The revised pro- 
gram deserves more detailed com- 
ment, but that will have to wait until 
some hours have been spent using 
the new and revised commands. 


Text87 Too 


As would be expected, changes 
have been made to Text87 to reflect 
the upgrading of LineDesign. There 
have also been a number of changes 
not related specifically to that pro- 
gram. The version numbers have 
been changing frequently in recent 
months, and may have gone beyond 
the 4.4 that appears to be current as 
of mid-November. 


Readers’ 
Letters 


Peter Hamill wrote an enthusiastic 
letter about LineDesign, which he is 
using to good effect on a newsletter 
for his local sailing club. The newslet- 
ter is a combination print, part done 
with Publishers’ Pack and part with 
Text87 alone. As with several “classic” 
DTP programs, you need to make the 
best use of two or three programs to 
get the results people expect these 


days - text from a WP program, perhaps graphics from a 
pukka drawing program, and the combination of text and 
graphics, partly from LineDesign and partly from multiple 
passes through the printer. This procedure may sound 
complex, but it need not be that bad. LineDesign obvious- 
ly is a drawing program, and the reason for suggesting 
the use of another graphics program in addition is that 
there are some good effects and “potted” images avail- 
able from non-QL programs, and it is tempting to make 
use of that which has already been created. LineDesign 
has the ability to import certain other types of file, such as 
those from Adobe Illustrator. It is highly desirable to have 
plenty of “spare” time, though, but that is what microcom- 
puting is all about, surely? 

One tip Peter passes on sounds novel - to copy an 
image onto the screen, using a mouse and LineDesign 
(or another graphics program), try tracing the image onto 
acetate sheet first, then place the sheet over the QL dis- 
play screen (it will stick there by static-electric attraction) 
and move the mouse pointer around the traced image on 
the acetate. 


Boats Laid Up! 


Had the whole newsletter not been available, a few 
phrases from it would have had me more than a little puz- 
zled. For example, “A total of 21 Squibs came together in 
clear blue skies” and “Squib Laying Up Supper’. The 
Squib is a class of small yacht, subject to race meetings 
and end-ofseason suppers for the sailors when the boats 
are put to bed. In several ways, Peter's use of the QL is 
typical of what a lot of home computer users do. If they all 
got results as good as he does, they would be quite 
happy. 

Changing tack a bit, Peter mentions the Psion 3, which 
impresses him. My own experience of it is very limited, 
confined to a recent session persuading one to transfer 
files to a “host” computer and print to a Canon Bubblejet 
printer. Without having touched one before, it didn't take 
me long to get the hang of both operations, despite the 
(usual) lack of accuracy in the instructions. File transfer 
took the longer time to sort out, purely because the pro- 
gram at the host end defaulted to a Baud rate of 19,200 
whereas the Series 3 offered no more than 9,600; the 
instructions did not mention this, as you can guess. 

It is quite simple to use. Apart from the tiny keys, which 
make typing a pain, it has much to recommend it. Several 
programs can be loaded, and switching between them is 
easy; it is commendably nippy, and is a very convenient 
size for carrying around. The .DBF format of the database 
files in it was unacceptable to Archive, but a .LIS conver- 
sion of a database file loaded into Quill without trouble. 
From recent comment in magazines, it would seem that 
the latest Series 3 is much better than the one referred to 
here, and it should be possible to pick the older model 
up for a lower price. 


Help - Sick 
Thor 


John Wakefield asks for help on something which is 
outside my range. Maybe a reader can help? He has a 


Thor and feels that the keyboard is faulty. The symptoms 
are variable effects from the Alt, Ctrl and Shift keys. For 
instance, holding down either the Shift or Alt key for any 
length of time apparently causes them not to function. 
Ctrl-R will cause a reformat in Perfection, but a second 
tap of R (with the Ctrl key still held down) may cause that 
character to appear on the screen. On the other hand, the 
effect of holding the Ctrl, Shift and Alt keys down can per- 
sist some time after they are released. Is this deliberate, a 
software problem, a keyboard malfunction, or something 
quite different? 

There must be many QL users who believe that all Thor 
activity has died out. One such user contacted me as a 
result of talking to the supplier Transform (yes, they are 
still active, but not in QL matters). The recent bout 
between Kasparov and Short had aroused the chess- 
playing enthusiasm of his mates at work, but they had 
battered their Psion Chess cartridges to death. He wanted 
to know if one of the program files could be re-copied 
onto his cartridge. That in itself should be a simple job 
(but was not); the weak link in the chain is not the copy 
used for playing, though, but the master cartridge which 
has to be there for the program to start at all, and his 
master would not play ball. There is a floppy disk version 
of Chess around, and it does not seem to need a master, 
but whether or not this has been doctored to work on its 
own, | do not know. It is unlikely that Psion still support it 
(for the QL, anyway). 


TF SERVICES 


MINERVA 


The ULTIMATE operating system upgrade 


HERMES 


A replacement QL co-processor for 
the QLs awful IPC 8049 


- Do you get keyboard bounce? 
- Do you find fast serial input unreliable? 
- Do you want to connect a modem at 19200bps 


MK{l MINERVA with battery tor 256 bytes ram, 
CRASHPROOF clock & Philips IC bus for intertacing J 
Can _autoboot irom battery backed ram. Quick start-up. 


Other features common to MKI/MKII If you can say oneYES , then you nced HERMES 
DEBUGGED opyrating system/ autoboot on resey 
Multiple Basic/ faster scheduler-graphies (10% of 
lighting)-string handlingy WHEN ERROR/2nd_ sereen/ 
TRACE/ foreign keyboard drivery ‘warm’ fast reset/ 
Auro reboot atter power failure. V1.97 now with built in 
Maltibasie and split OUTPUT baud rates with Hemies. 


+ 19200bps RELIABLE serial input- NO QCONNECT. 
+ Independent input baud rates - use serial mouse & print 
+ Stops keyboard bounce (unwanted repeat chrs) 
+ Improves “fuzzy” and ‘random’ sound 
~ Provides extra input/output lines 
~ Key click 
Ist upgrade: tree. Otherwise £3 (+ £5 for manual if requd) 
(send sac, Minerva & NEW disk/3 mdvs) 
Mk Ito MRIL upgrade - £30 


(MKI.... £35 MKII(RTC)... £60 ) 
GOLD CARD (v2.24+) COMPATIBLE 


QL SPARES 


Fitting is simple. Remove the QL top (8 screws) & 
replace the chip marked 8049 or 8749 next to mdy 1. 


£25 including manual/software 


I2C Interfaces 


The 12C bus was designed by Philips to simplity 
interfacing. Minerva MKII clock is driven by an PC 
chip, & a connector allows connection of other circuits. 
Our extemal circuits will interconnect without leads. 
Up to S interfaces can be powered off the QL. 


Faulty QL board (no plug-in chips)......£9 
Keyboard membrane........ £9 Circuit diagrams... 
68008 cpu 
JM ROM 
8302 ULA 
3049 IPC... 


Paralic! Interface Each gives 16 input/output lines, 
Can be used wherever logic level signals are required - 
eg model train controllers. Can input direetly to motor 


Arivers (Cg L29H29B)scsccssseseesssereecssareesseerivrsdeeD 


Analoguc Interface Each gives 8 analogue to digital 

inputs, and 2 digitaanaloguc outputs. For temp 

Measurement, sound sampling ete ........06 ae 

Data sheets. (analogue/parallel [2C chips). 

Control software/manual (Superbasic extms)......£2 
(First interface purchase includes free 15D/9D lead) 


Other components/(sockets ctc) please phone 


QL REPAIRS 


Fixed price tor unmodified QLs, excluding microdrives. 
QLs tested with Thom-EMI rig and ROM software 


QBBS - UKs first scrolling Bulletin Board 
Note the new telephone number below 
TANDATA callers must add $1X zeros (000000) or wait 
for 3 seconds of modem tone if dialling manually. 


£27 including 6 month guarantee 


Prices include post & packing (UK only). Payment by Mastercard/Visa/Access/Eurocard/cheque/postal ordcr/PO 
Giro transfer (58 267 3909). MAIL ORDER ONLY - no callers without ringing first. Ring for overseas prices. 


or 


Holly Corner, Priory Road, ASCOT, Berks, SL5 8RL 


MasterCar 
Fax & BBS: 0344-890987 ‘ 


0344-890986 
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Open Channel is where you have the opportunity to voice your opinions in Sinclair QL World. Whether you want to ask for 
help with a technical problem, provide somebody with an answer, or just sound off about something which bothers you, write 
to: Open Channel, QL World, The Blue Barn, Tew Lane, Wootton, Woodstock OX7 1HA 


Other 
Languages 


If you are interested in pro- 
gramming in Assembly, 
then check out Advanced 
QL Machine Code by 
A.Denning, The Sinclair 
Qdos Companion by 
A.Pennel, QL User January 
and March 1986, ‘Of Disks 
and Drives’ by Colin Opie, 
and the recent SQLW series 
Systematic Machine Code 
Programming and 
Beginners’ Machine Code 
by Alan Bridewell. 

The strengths of 
SuperBasic have until 
recently kept C at bay. 
However, | feel the tide is 
changing in favour of C, 
especially since the release 
of the cheap PD C compiler 
(see QL World, March 1992, 
‘Inside the C68 compiler by 
Simon Goodwin) and PD C 
tutorial packages. The Cport 
utility (see QL World Dec 
1992 ‘Cport Review’ by 
Shirley Butler) has much to 
do with the emerging popu- 
larity of C as it is able to 
convert SuperBasic pro- 
grams into C code with the 
minimum effort. C has 
received more than its fair 
share of exposure in QL 
magazines with a number of 
product reviews and articles 
on using C - QL World 
September 1990, November 
1990 and February 1991, 
‘Programming in C’ by Andy 
Wright, and QL user 1985, ‘C 
series’ by A Denning. If you 
are interested in C, then 
check out your local library 
or order copies of the follow- 
ing articles (your library may 
have these in archive) - PCW 


June 1989, ‘ANSI C’ by N. 
Martin and PCW January to 
May 1985, Teach Yourself C’ 
by L Hampson. 
Alan Wilson 
Stenhousemuirr 


Good Dreams 


Following Tony Rushton’s 
very kind offer to create a 
printer driver for my Citizen 
Swift 24, | enclose photo- 
copies of the escape codes. 
| would be extremely grateful 
if you could pass these 
along to him with the SSAE 
and my thanks. 

Speaking of thanks, could 
you also thank Dilwyn Jones 
on my behalf for providing 
the Z88 information. | would 
have written earlier, but I’m 
afraid that I've been extreme- 
ly busy recently, working 
abroad and _— getting 
engaged among other 
things! It is nice to be 
involved in a community 
which is so helpful - | must 
confess that once | almost 
left the QL in favour of the 
Amiga, but now I'm getting a 
PC with QXL card once 
funds are available (ie not for 
some time)). ; 

Lastly, would you let your 
readers know that my 
adventure game 
Dreamlands, formerly pub- 
lished by CGH Services, is 
now freely available as 
Charityware. | have sent 
Qubbesoft a copy which 
explains the concept in the 
Quill_doc file. The name of 
CGH still appears on the title 
screen but the game is now 
no longer a commercial one. 

Jean Yves Rouffiac 
London 
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Colour Stuck 


In QL World Vol II.9 you 
published in Open Channel 
an interesting tip from Bruno 
Coativy on cursor colour 
change. | tried it immediate- 
ly on my JM-rom QL with 
Gold Card 2.23. Unfort- 
unately, it does not work, 
because it is not possible to 
poke the required colour 
mask into the address found 
by function “adresse$” (in 
my case $24A8). The con- 
tents of this address are 
changeless, and are set to 
the colour red! Having Bruno 
Coatiw’s idea in mind, | tried 
also to modify the original 
QL character definitions in 
Font 2, with the same nega- 
tive result. The investigated 
ram locations of the Gold 
Card ($24A8, $A530 
$A770) behave in like man- 
ner to the rom. Where or 
what is the reason for this? 

Dr. Vladislav Teply 
Prague 
Czech Republic 


Stuart Honeyball writes: 
The address $24A8 lies in 
the QLrom's address space. 
This ram used by the current 
Gold Card is write-protected 
to prevent programs that 
attempt to write to the QL 
rom's space from causing 
corruption. Earlier Gold 
Cards did not have this pro- 
tection, and so allowed 
writes to this space. 


All At Sea 


In Vol Il issue 7 (| think the 
July issue) you have a 
review of a naval battle 


game program, Fleet 
Tactical Command. As my 
employers may allow me to 
buy my now rather old-fash- 
ioned IBM PC 286, | would 
like to know where to get 
the serial lead mentioned, 
and how | would to connect 
the PC and the QL together? 
lan Marsh 

Sheffield 


For all information about 
FIC, talk to Dilwyn Jones at 
DJC (0248 354023). 
However, a good source of 
all leads and information 


about them is Tony 
Firshman at TF Services 
(0344 890986) 


You are right about II.7 
being the July issue. The 
issue number is the number 
of the month UJanuary = 1, 
February = 2 and so on). We 
made a mistake in August 
and repeated I/I.7 on the 
cover, however, I8 is correct 
on the Contents page. 
Likewise, the first issue with 
the Volume/issue number 
system, in April, has (quite 
correctly) IL4 on the cover, 
but (also correctly) “April 
1993” on-the Contents page, 
to help people pick up the 
new system. 

We thought it would save 
our printers confusion, as 
some of the issues are rather 
loosely attached to their 
proper months at the 
moment But not everyone is 
happy - one reader thought 
that IlL7 was the April issue! 
In our defence, the photo 
feature in QL Scene does 
say “5th June’. We have a 
few grumbles when things 
are late, but not normally that 
they are two months early! 


Looking to Help 


The Royal National 
Institute for the Blind is seek- 
ing volunteers familiar with 
personal computer tech- 
nology to help look after 
customers on its Electronic 
Newspaper service. The 
Electronic Newspaper is a 
self-funding service provided 
by Electronic Text Network 
Associates (ETNA), a joint 
venture company led by 
RNIB. Using the ETNA ser- 
vice, blind and partially sight- 
ed people have indepen- 
dent access to a daily news- 
paper, something which 
many sighted people take 
for granted. 

The Electronic Newspaper 
consists of the text of The 
Guardian newspaper, trans- 
mitted each night via teletext 
Packet 31, which is received 
by the user on a convention- 
al TV aerial connected to a 
proprietary decoded board 
fitted into the users PC. The 
PC runs a TSR that decrypts 
the signal and stores the 
incoming files to the hard 
disk. When the user wishes 
to read the newspaper, the 
articles are read by synthetic 
speech, or on-screen by 
character magnification soft- 
ware, or by touch using a 
moving braille display (soft 
braille). 

Access to computers is 
becoming easier for blind 
and partially sighted people, 
thanks to recent improve- 
ments in synthetic speech 
devices, but unless they are 
familiar with the technology, 
some users may have diffi- 
culties installing the PC 
decoder card and software. 
The user can purchase the 
card and software from the 
RNIB, but to keep down 
costs, the RNIB would like to 
find volounteers in all parts 
of the UK familiar with PC 
technology who could help 
our customers with installa- 
tion and, where necessary, 
troubleshooting. 

The volunteer would be 
asked to visit the customer 
when the decoder card and 
software are delivered, to 
help them fit it in their own 


PC. Once the system is up 
and running, the volunteer 
may be asked from time to 
time to visit the customer if 
there are any particular diffi- 
culties. Each volunteer 
would only be asked to look 
after one or two people; trav- 
elling expenses are avail- 
able. 

As some of your readers 
may know, we already have 
over 3,000 valuable volun- 
teer engineers looking after 
the servicing of RNIB Talking 
Book players. Many “servic- 
ing visits” lead to friendships, 
and with the Electronic 
Newspaper, there is the 
opportunity for the volunteer 
to demystify the PC for the 
user, and to learn abut com- 
puter access technology for 
blind people. 

If you would like further 
information about becoming 
an RNIB computer volunteer, 
please contact me at the fol- 
lowing address: 


Prospect House, 
Prospect St, Huddersfield 
HD1 2NU. Tel. 0484 


450982. Fax: 0484 450703. 
David Finlay-Maxwell 

PhD MIEE 

Royal National Institute 

for the Blind. 


The RNIB are looking 
mainly for PC volunteers, but 
some QLers are PC users 
as well and others may 
know someone who would 
like to know about the 
Electronic Newspaper, or 
who needs similar assis- 
tance with a QL or related 
format. 


New 
Generation 


| am not sure as to the 
possibility of obtaining a 
copy of Family Tree, that 
used to be advertised in the 
Microdrive Exchange. | typed 
it from the original issue 
(August 1985), and have 
continued to use it repeat- 
edly since, with the draw- 
back of having to print out 
individual family groups! | 
noticed that more recent 
copies have an extended 


family tree ability. As our 
family reaches back to 
England beyond the eigh- 
teenth century, this facility 
would be a great help. The 
name of Cooper is of course 
linked to the old occupation 
of barrel-making, so it may 
go back a few centuries! If 
Family Tree is still available, 
could you plese let me 
know the price etc? 
Keith Cooper 
Morrinsville 
New Zealand 


| have had this letter for 
some time and correspond- 
ed with Keith Cooper. 
However, as we never man- 
aged to regain our master 
copy of Family Tree, or make 
contact with author Andy 
Carmichael, and as there 
are many keen tracers of 
family trees still out there, | 
thought | would draw atten- 
tion again to the newest ver- 
sion of Chris Boutal’s QL 
Genealogist 3, available 
from Dilwyn Jones. The new 
version costs £60, but there 
are alternative versions at 
£30 and £12 as well. 


IL8 Or Not 11.8? 
| read in QL World 119 that 


some users have not 
receieved 1I.8 - watch out as 
QL World II.8 has on the 
cover page reported II.7! 
Instead the correct number 
is reported in the “Contents” 
page. Maybe some users 
have been fooled by this 
printing error! 
Davide Santachiara 
Ergon Developments 
Italy 


Despite all I've said, they're 
not that easily baffled! There 
really was a batch of II.8 
bound for Continental 
Europe that didn’t reach its 
destination, and Fran has 
been sending replacements. 


AArk! 


More information about 
the QL-generated picture of 
a Kingfisher, drawn by Dave 
Barker of Charvelsoft, now 
that it has made it on to last 
month's cover. The image 
(used here with Dave's 
express permission) is avail- 
able on a public domain 
disk formerly distributed by 
CGH Services, and now by 
the West Midlands Quanta 
sub-group disk library. 

Simon Goodwin 
West Midlands 


Editor's Notebook 


Our leader article this month is about artificial 
intelligence, and gives an experimental demon- 
stration program for the QL Dr. Steven Wilcox is 
an academic working in artifical intelligence, and 
a QLuser (a sign of real intelligence), so he 
knows the subject from both sides. 

This issue introduces the new slimmed-down 
QLWorld. Like most businesses that go into this 
euphemistically-termed operation, we are not 
happy about it, but, as the changes in our adver- 
tising layouts over the last few months make 
clear, the slow decline in the market and the 
pressure caused by the recession is affecting 
everyone who relies on the open marketplace. 
Oh for a bottle full of QL-using genies to do our 


bidding! 


Our reduced space makes it more important 
than ever to know what you, the readers, like and 
don't like each month, Don't be shy - let us 


know. 
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New Home for London Quanta 


The Quanta London Subgroup is back to regular meetings at a new venue in central 
London. 

Meetings will now be held on the second Sunday of each month, between 1pm and 
6pm, at St Aloysius’ Primary School, Phoenix Road, Euston, London NW1. 

Phoenix Road is at the Euston end of Eversholt St, close to Euston Underground, and 
10 minutes’ walk from Kings Cross and Euston Square undergrounds. Several buses 
pass nearby, and there is car parking in the area. 

The meetings are open to all interested in the QL Admission is £2 on the door to 
cover the cost of the Hall, and organiser Colin Murphy (071 383 0007) is looking for 
people to give talks and demonstrations on hardware or software. A few weeks’ notice 
of talk subjects is helpful, as is notice if you intend to bring hardware, so that they can 
arrange enough tables. 

Among regular members at the moment are Fred Toussi of Software 87, Jerry Davis of 


QPacer, and programmer Mark Knight. 


ALL 
FOR- 
MAIS 

DIARY 


Coming dates for the All Formats 
Computer Fair are: 

20 Nov London Sandown Park 
Racecourse 21 Nov Portsmouth 
Guildhall 27 Nov Haydock Park 
Racecourse, M6 J23 28 Brunel Centre, 
Temple Meads Station, Bristol 4 Dec 
Leicester De Montfort Hall, Granville 
Road 5 Dec North East: Washington 
Leisure Centre, District 1 11 Dec West 
Midlands National Motorcycle Centre, 
M42 J6 12 Dec Leeds University 
Sports Centre, Calverlely St. 18 Dec 
Edinburgh Adam House, Chambers 
St. 19 Dec Glasgow City Hall, 
Candleriggs CHRISTMAS BREAK 15 
Jan Haydock Park Racecourse, M6 
J23 16 Jan Brunel Centre, 
Templemeads Station, Bristol. 

The All Formats Fairs are going to 
many more venues now. Although you 
will not find QL traders at every one, 
they are good browsing places for 
multi-format users and general sup- 
plies. Check with suppliers whether 
they will be at a particular Fair. If you 
have far to travel phone All Formats 
0608 663820 to check arrangements 
haven't changed. 

Day tickets are £4; you can get up 
to 50 £1-off vouchers by sending -an 
SAE to the organisers at: Maple Leaf, 
Stretton-on-Fosse, Moreton-in Marsh, 
Gloucestershire GL56 9QX. 
Photocopies of these vouchers are 
OK. Admission is a flat £2 between 
2pm and 4pm. £1-off vouchers do not 
apply at these times. 


Miraculous 
Progress 


Miracle Systems came back from the QL 
show at St Joris’ College, Eindhofen, on 30th 
October, well satisfied with their visit. The QXL 
Card software has now reached the stage 
where only the SBasic is to be completed, but 
Miracle are in a cagey mood about announc- 
ing which of their eagerly-awaited new prod- 
ucts will be the next to appear. 

Stuart Honeyball tells us: “We want to make 
sure that we do the new product that a lot of 
people want, and that we can support it prop- 
erly, and we can only support a certain amount 
of products at a time. So we don’t want to 
announce time scales on new products yet. In 
a way | wish we hadn't announced the graph- 
ics card as early as we did, but we want some- 
thing really good and we are not going to 
compromise.” 

Miracle also have the services of student 
Benjamin Wikes to work on the SCSI interface 
while he is doing his sandwich course. 
Commenting on working standards among 
young engineers, Stuart said: “We find that 
whether people are enthusiastic or not is the 
most important thing’, a comment that many 
others will agree with. 

One of the challenges facing the graphics 
card is that much established QL software is 
written for the native QL graphics that the card 
is designed to go beyond. Programs written for 
the pointer environment can handle higher res- 
olutions, but within the QL community, Stuart 
says, when the time comes there will need to 
be some rewriting of software to make use of 
improved graphic modes. 

In line with their policy of committing their 
resources to current and new projects, Miracle 
are no longer marketing the ED drives which 
they introduced to help Gold Card users obtain 
reliable disk drives. The drives can now be 
obtained from Bill Richardson at W N 
Richardson (EEC) on 0753 887149. 
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TF SERVICES BRINGS OUT 
l2¢ BUS INTERFACES 


TFServices have designed two 
hardware interfaces based on 
the parallel and analogue I2C bus 
chips used by the Minerva Mk. 2 
rom to run its clock and battery- 
backed ram. Each interface con- 
tains two I2C chips, each of which 
can have one of eight addresses 
(set with DIP switches). 

Power and signals are taken 
from the Minerva connector, and 
at least four interfaces can be 
powered without any external sup- 
ply. 
The TF package provides soft- 
ware to make reading and writing 
to the devices easy. 

12C compatible hardware on the 
general market includes phone 
diallers, teletext chips, and radio 
and TV controllers. Minerva will not 
allow the use of microprocessors 
or other devices which need dual 
bus masters. 

More information next month. 
For enquiries, contact Tony 
Firshman at TFServices, Holly 
Corner, Priory Road, Chavey 
Down, Ascot, Berks SL5 8RL. 
See also Tony's ad. in this issue of 
QLWord. 
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Simon 
Goodwin 
unveils eccen- 
tric SuperBasic 
to tame the 
Motorola 
68020, 68030 
and 68040 
processors. 


The new 82 bit proces- 
sors in Motorola's 68000 
family are upward-com- 
patible with their eight and 
16 bit predecessors, so 
they can run the same 
code. This means that 
Qdos users should be 
able to upgrade to the 
new chips and run their 
existing programs at high 


problem in two ways - 
either by clearing the cache 
before you use the self- 
modifying code, or by turn- 
ing it off completely. The 
first approach gives better 
performance, but the sec- 
ond is more reliable, espe- 
cially if you do not know 
exactly when the cache is 
invalidated. 

The 68020 processor, 
used in the Thor 20 and 
Amiga 1200, has a 256 
byte code cache. The 
68030 adds a 256 byte 
cache for data, and the 
68040 expands both to 4K 
each, increasing the 
chance that required code 
or data will be available on- 
chip. 

The ‘memory manage- 
ment unit’, or MMU, makes 
an appearance in top of 
the range MC68030 and 


MC68040s, and the new 
LC68040. The MMU trans- 
lates addresses so that 
memory can be re-located 
without the need to copy 
the entire contents from 
one place to another. Qdos 
has no need of a memory 
management unit, and pro- 
gram performance is 
improved if you turn it off. 


Why 
SuperBasic? 


This month's column is a 
hybrid of SuperBasic and 
machine code. The pro- 
grams are in SuperBasic, 
yet they access the nitty- 
gritty inards of Motorola's 
32 bit processors. | could 
have written the programs 
in an assembler - they gen- 
erate a small machine- 


speed. 

Much of the 
extra perfor- 
mance of the 
new chips 
comes from 
speed-up cir- 
cuits which 
did not 
appear in the 
original 68008 
and 68000. 
Some QL pro- 
grams which 
have worked 
reliably for 
years fall foul 
of the new 
hardware, so 
QXL, ST and 
Amiga emula- 
tor users 
need to be 
able to turn 
features on 
and off. These 
SuperBasic programs do that job by updating 
Motorola's processor control registers. 

For instance, the ‘code cache’ stores instruc- 
tions locally inside the processor. This saves 
time, but can cause erroneous results if you 
run programs that patch their own code, like 
Speculator, Lightning and the original Turbo 
Toolkit implementation of SEARCH_MEMORY. 


set 


Cache Control 


The processor may carry on running the 
original code from the cache, ignoring the 
new version in memory. You can avoid this 


REMark 68040 MMU and CACHE control extensions 
REMark SuperBasic in Action, Simon N Goodwin 


DEFine PROCedure CACHE(d,c) 

Local x 

IF UNSET(d) THEN d=1 

IF UNSET(c) THEN c=1 

x=ALCHP (20) 

POKE_W x,20032:REMark SV mode 

POKE_W x+2,8764:REMark Load D1 

POKE_W x+4,-32768*(d<>0):REMark Data 

POKE_W x+6,-32768%*(c<>0):REMark Code 

POKE_W x+8,BIN("0100111001111011") :REMark MOVEC 
POKE_W x+10,HEX("1002"):REMark Move D1 to CCR 
POKE_W x+12,636:REMark User mode 

POKE_W x+14,-9985 

POKE_W x+16,HEX("7000") 

POKE_W x+18,HEX("4E75") 

CALL x 

RECHP x:REMark Phew 

END DEFine CACHE 


DEFine PROCedure MMU_OFF 

LOoCal x 

x=ALCHP (20) 

POKE_W x,20032:REMark SV mode 

POKE_W x+2,8764:REMark Load D1 

POKE_L x+4,0:REMark Disable MMU 

POKE_W x+8,BIN("0100111001111011") :REMark MOVEC 
POKE_W x+10,HEX("1003"):REMark Move D1 to TCR 
POKE_W x+12,636:REMark User mode 

POKE_W x+14,-9985 

POKE_W x+16,HEX("7000") 

POKE_W x+18,HEX("4E75") 

CALL x 

RECHP x 

END DEFine MMU_OFF 
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code routine as they work - 
but it was more sensible to 
develop them in 
SuperBasic. 

The programs use the 
MOVEC instruction, which 
was introduced for the 
68010 processor and later 
models. MOVEC allows 
access to special ‘control’ 
registers which do not 
appear in the earlier 68008 
used in the QL, nor the 
68000 of Amiga, ST, Thor 
XVI and Gold Card. Current 
QL assemblers do not 
recognise the MOVEC 
mnemonic, although it can 
be entered as a data word 
if you know the right code. 

Recently | had the 
chance to try out Amiga 
Qdos on the EC68030 and 
MC68040 processors, and | 
wanted to use MOVEC to 
configure the chips. Within 
a few minutes | had a work- 
ing SuperBasic program to 
generate and call the nec- 
essary code. 

lf you are developing a 
large assembler program it 
is best to include the 
MOVEC routine there, but if 
all you want is a way to 
switch the special features 
of your processor, there’s 
really no need to leave 
SuperBasic. 

The SuperBasic version 
is ideal for experimentation 
because you can edit any 
part and try out the change 
straight away. Once a 
skeleton routine is working 
you can tweak it to use any 
of the 680X0 control regis- 
ters. 

| started with a single pro- 
cedure to switch the 68040 
caches on and off. | only 
needed to change a cou- 
ple of values to gain control 
of the Memory 
Management Unit, and 
then all the special control 
registers of the 68030. 


The listings 


Listing one is for the 
68040, including the EC 
and LC versions. There is 
no point in using the 
MMU_OFF command on 
an EC68040 board such as 


the QXL, as EC 
chips have no 
MMU. 

The listing 
implements 
two com- 
mands: 
MMU_OFF and 
CAC HE: 
CACHE takes 
two optional 
parameters, 
which control 
the data and 
code cache 
respectively. 
Lines 150 and 


REMark 68030 cache control commands, 


version 1.1, 15-11-93 


REMark Simon. N Goodwin, Andreas Rudolph, Davide Santachiara 


DEFine 


PROCedure MOVECC(op) 


LOCal x 
X=ALCHP (20) 


POKE_W 
POKE_W 
POKE_L 
POKE_W 
POKE_W 
POKE_W 
POKE_W 
POKE_W 
POKE_W 
CALL x 


160 use the 
DIY Toolkit 
UNSET func- 
tion to check if 
parameters 
were supplied, 
and set them 
to one other- 
wise. If you 
lack UNSET, 
from DIY 
Toolkit Volume 
P, you should 
miss out those 
lines, and both 
parameters 
MUST be sup- 
plied. 

By default 
CACHE turns 
both caches 
on; CACHE 0 
disables the 
data cache and enables 
the code cache. CACHE 1,0 
enables only the data 
cache, and cures most 
problems with self-modify- 
ing code. CACHE 0,0 is the 
slowest and most compati- 
ble option. 

The POKEs store code in 
a 20 byte buffer on the 
common heap. The first 
word, 20032, is the 680X0 
code for TRAP #0, and 
selects Supervisor mode on 
a Qdos system. This is nec- 
essary because the 
MOVEC instruction is ‘privi- 
leged’ and cannot be exe- 
cuted in the normal ‘user 
mode. 

The next word, 8764 in 
decimal, is the code to load 
the subsequent long word 
value into register D1. Lines 
190 and 200 check the 
parameters and store - 
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x,20032:REMark SV mode 
x+2,8764:REMark Load D1 
x+6,Op 


x+8,BIN("0100111001111011") :REMark MOVEC 
x+10,HEX("1002"):REMark Move D1 to CCR 


x+12,636:REMark User mode 


x+14,-9985 
x+16,HEX("7000") 
x+18,HEX("4E75") 


RECHP x 
END DEFine MOVECC 


DEFine PROCedure DCACHE_START 
MOVECC HEX("3911"):REMark Both on, 
END DEFine DCACHE_START 


DEFine PROCedure CCACHE_START 
MOVECC HEX("3119"):REMark Both on, 
END DEFine CCACHE_START 


DEFine PROCedure CACHES_OFF 
MOVECC HEX("2808"):REMark Everything off 
END DEFine CACHES_OFF 


DEFine PROCedure DCACHE_ONLY 
MOVECC HEX("3908"):REMark Data on, clear both 
END DEFine DCACHE_ONLY 


DEFine PROCedure CUCACHE_ONLY 
MOVECC HEX("2819"):REMark Code on, clear both 
END DEFine CCACHE_ONLY 


32768 or zero in subse- 
quent words, depending on 
the parameter values. The 
68040 Cache Controls only 
use one bit, the most signif 
icant in each word. If this is 
set the cache is turned on. 
-32768 corresponds to 
1000 0000 0000 0000 in 
binary, or 8000 in hexadeci- 
mal; it easy to see how 
only the top bit is used in 
these values. 


Motorola Op- 
code 


The next instruction is the 
MOVEC op-code, which 
never appears in QL code, 
so | got the pattern from the 
Motorola Programmers 
Reference Manual, which 
expresses op-codes in 
binary. | could have con- 


clear data 


clear code 


verted it, but there’s little 
point in doing so, and run- 
ning the risk of error, when | 
can type the binary directly 
into SuperBasic and evalu- 
ate it with the BIN function. 

MOVEC is always fol- 
lowed by a second word, 
indicating the source and 
destination registers. In this 
case the most appropriate 
base is hexadecimal; the 
first four bits of the word 
contain the register num- 
ber, 0 to 7 for DO to D7, or 8 
to F for AO to A7. 

The remaining bits select 
a control register; 002 signi- 
fies the Cache Control 
Register, and 003 the 
Translation Controller. 
There are a few other pos- 
sibilities, which depend on 
your choice of processor; 
for instance 801 is the 
Vector Base Register, which 


allows reset, interrupt and 
trap vectors to be re-locat- 
ed to an address other 
than zero. To find out more, 
consult the Motorola manu- 
al for your processor. 

The next two words return 
the processor to user 
mode, once the privileged 
MOVEC has been done. 
The hexadecimal 7000 op- 
code sets register DO to 
zero. This is one of the few 
68000 instructions that’s 
easy to assemble by hand. 
The seven indicates 
MOVEQ, the second hex 
digit is the register number 
times two, so 74 would 
move a value to D2. The 
last byte is the value to be 
moved, so 7608 is the code 
for MOVEQ #8,D3. Easy! 

The last instruction is 
4E75 in hex, “Nu” in Ascii, 
and RTS in mnemonic 


assembly code. It marks 
the end of the code and 
returns control to the caller 
- SuperBasic’s CALL in this 
case. The final step is to 
deallocate the buffer with 


RECHP. 

MMU_OFF needs no 
parameters. The bulk of the 
code resembles that for 
CACHE. A sequence of 20 
bytes is stored and then 
called, but in this case the 
code clears TC, the 
Translation Control register. 


68030 Range 


Listing two is for the 
68030 range, tested on an 
Amiga 4000/EC 030. The 
030 uses a different control 
register format, with extra 
bits to clear all or part of 
either cache, so you can’t 
just use the 68040 version. 

The listing implements 
five commands: 
CACHE_OFF, which works 
like CACHE.0,0 on the 
68040; DCACHE_ONLY, like 
CACHE 10; and 
CCACHE_ONLY, which 
turns on the code cache 
but not the data one. 

The remaining com- 
mands leave both caches 


on, but clear one or other 
so new memory contents 


are recognised. 
CCACHE_START clears the 
code cache, while 


DCACHE_START does the 
same for data. All five pro- 
cedures call MOVECC, 
which sets up the bulk of 
the MOVEC code and stuffs 
a parameter into the low 
word of D1. 


Conversions 


The program uses base- 
conversion functions HEX 
and BIN from Toolkit 2. The 
HEX function also appears 
in Mark J Swifts PD Toolkit. 
If your super-QL lacks these 
functions you can replace 
the values with their deci- 
mal equivalents, but this 
will make them more diffi- 
cult to change, particularly 
in the case of BIN, where 
each binary digit has a 
special significance to the 
processor. 

The generated code is 


stored in a temporary area 
of memory allocated on the 
common heap. The pro- 
gram uses the Toolkit 2 
function ALCHP to allocate 
memory, and RECHP to 
discard it after use. If you 
lack Toolkit 2 you may use 
either the eponymous PD 
Toolkit functions, or ALLO- 
CATION and DEALLOCATE 
from Turbo Toolkit, or 
RESERVE and DISCARD 
from DIY Toolkit Volume H. 


This is not a typical 
SuperBasic in Action pro- 
ject, but it does show the 
sort of low-level access that 
is possible with POKE and 
CALL Next month | shall be 
back with more convention- 
al SuperBasic program- 
ming. In the meantime | 
hope 32 bit Qdos users 
find these little procedures 
useful, and welcome sug- 
gestions for future columns. 


Im stillen Winkel 12 . 47169 Duisburg . Germany . Tel and Fax: 0203 501274 . Mailbox: 0203 591706 


typeset93-ESC/P2 NEW! BlackKnight - the first mouse-driven Chess program QlL-Emulator for ATARI 
Dedicated text87 printer drivers for all EPSON printers Yes, here it is - chess for the Pointer Environment! Moveable, runs on any dis- QVME - High-Res QL-Emulator for ATARI 
with ESC/P2 including the new Stylus 800. Supports the play resolution! 5000 moves opening library, demo made, setup, change Maga STE and ATARI TT DM 695, 
scalable fonts, special characters and block graphics sides, load and save game, hint, scrollable move-history etc. 10 Levels of diff- E-Init Emulator Software [E34] DM 49,- 
for drawing borders etc. DM 69,90 culty, giving the computer between 5 seconds to | hour time to think. E-Init Update with new manual DM 16,- 


BlackKnight even thinks when its your tum. DM 119,90 NEW! QL-Emulator Brochure DM 13,- 
QMAKE NEW! Madlum for SyQuest 44MB_ DM 139, 
Pointer-driven Make program for the GST/Quanta The Lonely Joker Version 2! | 
Assembler package. Very comfortable, with many Now six different games in one! Another three, even more complex patiences Applications 
options including liprary-building). DM 44,90 have been added to the existing three: Spine, Crapaud & Four-in-a-Hand(two QDOS Reference Manual DM 89,9 
NEW! of them work with two packs of cards). More options(different pattems for the pes a a 
The Oracle - an ancient tactic-puzzier. You don’t have reverse side of the cards), high-scores, moveable window for hi-res screens QsUP DM a 
to be fast but clever Fill different tiles into a field, but etc DM 59,- (double fun-half the price) DM 29,- NEW! ala DM 699 
there are various rules how to do it If you can place all Thing & EPROM Manager DM 61.5 
the tiles you get a bonus - try to obey special ules. @Spread - the only Spreadsheet program for the Pointer Environment —EasyPTR Part 1 DM 89,- 
Every game is different, you'll never be bored. Features: Completely mouse and/or keyboard-controllable! Maximum 32768 ceiis, Part 2 Di 
high-score table,hints for the next move etc DM 39,90 where, for example, 16000 cells need about 400kBytes. Macro functions. 49,- Part 3 DM 49,- 
Easy, quick and comfortable block handling and entry. Many additional func- DataDesign V3 DM 149, 
QD Verzion 5 - Very comfortable Editor for the Pointer tions, which belong to today's standard-equipment: Help, Button, use of the SYSTEM DM 80,- 
Environment now with Help System! [V5.16]. DM 125, Scrap. The current version adds missing features and more, eg. cell-reference- QDesign || DM 150, 
Upgrade from QD V4 {retum master disk) DM 30,- adjustment, echo, IF and comparisonstoolbar, time & date functions. v1.22] VecEdit DM 60,- 
QSpread with comprehensive manual DM 169,- Update with new manu- 
HyperHELP for SuperBASIC al (useful if old version Is <1.20) DM 16,- QSpread Demo Version - send 3 Games 
Instant help in SuperBASIC! It displays a list Of Intemational Reply Coupons if ordered alone, otherwise enclose a spare disc pj \ DM 35,9 
SuperBASIC Procedures, functions and keywords cur- with an order or update and itis free! ae nS i 9 
rently existing in your machine. Simply click on the name Beainomasher Sepli 
and you get extensive help (English or German]. The QL Hardware & Spares aac a oe 
re eta C apstapeirs hog cite hae - FLPIRAM Level 2 device drivers for SuperQBoard DM 56, _ SuperGamesPack DM 90,- 
easel a or siti FLPIRAM Level 2 device drivers for TrumpCard DM 56,- — @Shang DM 45,9 
a: : SER Mouse software driver DM 40,- 
QMenu - the Menu Extension. QMenu is an interface eee Package inquseodantor & diver Ba ee 
with pre-defined menus ey A file-selectsim- 7¥g399 DM 1790 
ple-choice boxes, select from lists). The menus can be e i 
used from SuperBASIC, machine code and other lan- elie ag membrane DM 28,- a ria Merry Christmas & 
guages. New character-select menu. [V4.16] DM 39,90 Eppa, 97128 DM 5 Happy New Year ! 
Update with new manual DM 16,- SIMM 256k x 8 DM 3.50 


Postage and package (Europe) DM 15,-lif total value of goods is up to DM 50,- then only DM.9,-) ‘ a 
(Overseas) as before, but add DM 8,- per additional item. All prices incl. 15% VAT. (can be deducted for orders from non-EEC- |i Spare as 
countries), E&)OE, Cheques in DM, z's, Eurocheques and Credit Cards accepted, Re i 


French QL 
Group QL Contact 
France are hold- 
ing their Annual 
General Meeting 
in Paris on 
Sunday 5th 
December. 
Contact Jean 
Louis Dianoux, 
22 Ave. Lenine, 
93230 
Romaineville, 
France, 


Starting With The Prolog 


Grange Technology of Didcot have introduced a new high performance implementa- 
tion of Prolog for the QL GT-Prolog can be used on any QL with 512K or more of 
memory. Combining speed with low memory overhead, the program provides an inter- 
active development environment supporting incremental compilation and debugging of 
Prolog applications. 

GT-Prolog is a full implementation of the Edinburgh dialect used widely in industry 
and education, and as the basic standard referred to by the British Standards Institute 
and International Standards Organisation. This implementation is also highly compati- 
ble with other major Prolog systems, giving immediate access to existing application 
code, documentation and training material. 

GT-Prolog features a full range of data types and gives transparent access to optimi- 
sation techniques including In-line Arithmetic Evaluation and automatic Garbage 
Collection of code and data. It is also one of the first implementations to support a fully 
logical Prolog database. It provides explicit control of memory allocation, allowing pro- 
grams up to 16 megabytes. Execution speed measured using Naive Reverse exceeds 
5K LIPS (logical instructions per second) on a 16 MHz Gold Card. 

The associated Workbench gives a powerful integrated toolset for code development, 
with a fast incremental compiler, a multi-port debugger on the Byrd model and a 
source code model, all employing a menu/dialogue user interface. The Workbench is 
implemented in Prolog using the same 130+ family of library predicates which provide 
users programs with full access to Qdos facilities. 

Prolog has gained widespread use in symbolic processing and artificial intelligence, 
and increasingly in less specialised applications. The GT-Prolog package includes soft- 
ware on disk, and an 150-page A% User Guide and Manual. The single-user price is 
£89.85 inclusive of VAT and carriage. 

For more information contact Graham Thwaites, Grange Technology Ltd., 
Rosebank, Stream Road, Upton, Didcot, Oxon OX11 9UG. Tel. 0235 851818. 


Ergon make prices simpler 


Ergon Developments in Italy have altered their pricings - to include all post and packing and bank 
charges. This will be gladly received by users who had to keep adding up the noughts on the Lire 
prices! As well as the arithmetic boon, all Ergon’s manuals have been revised and extended, and have 
tutorials with many step-by-step examples, and are also laser printed for extra clarity. Existing Ergon 
customers who would like the revised manuals should contact Ergon for information. 

Ergon’s DEA Intelligent Disassembler is now into version +3, with interactive machine code decod- 
ing and a new 52-page manual. The cost is £28. MasterBasic 1.43 costs £22, Q-Library Manager 2.11 
is £18, Ergon Floppy Disk Utilities is £18 (this is version 1.13, with disk utilities for Gold Card High 
Density and Extra Density disk users, allowing a format of 5% extra capacity, +160 kilobytes on ED 
disks); Open World is £18 and Music Manager is £12. 

On the Spectrum Emulator front, both ZM/hT (which runs at full ZX speed on a Gold Card QL, as 
well as a reasonable speed on standard QLs) and ZM/128 now have 3-channel sound-chip emulation 
through the QL beeper. ZM/hT is now up to +1 while ZN/2 and ZM/3 have been upgraded to /hT 
supervisor level, +3. ZM/ACcessories now also include Tapefile to Speculator conversion in both direc- 
tions, with a new 90+ page manual. Emulator prices are: Bargain package (ZM/hT.ZM/128 public 
domain versions + ZM/AC manual, £20; Budget package - as previously, plus ZM/2 and ZM/3 £30: 
Professional package - budget package plus ZM/hT £42. ZM/128 can be added to any of these for an 
extra £10. 

For the updated Ergon Demo Disk, with PD or demo versions of most of these programs, either 
send 6 IRCs (international reply coupons) to Ergon, or apply to your nearest Public Domain dealer 
(Qubbesoft or SUPD in the UK). There is also a special Spectrum emulator PC disk with ZM/hT and 
ZM/128 PD and some games and shareware. 

Contact Ergon at: Davide Santachiara, Via Emilio De Marchi 2, 42100 Reggio Emilia, Italy. Tel. 
(from UK) 010 39 522 70409, Please make payments with orders out to Davide Santachiara. 


SQLUG are holding a workshop in Edinburgh on Saturday 12 February 1994. For details get in 
touch with Alan Pemberton, 68 Lingerwood Road, Newtongrange, Nidlotian EH22 4QQ. 
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THE 
NEW 
USER GUIDE 


KEYWORD INDEX 


In the last part of the Keyword Index, Mike 
Lloyd goes through WHENs, WIDTHs and 
WINDOWs 


WHEN <expression> 
<commands> 
CONTINUE 
ENDWHEN 


WHEN <expression> : 
<commands>: CONTINUE 


WHEN var 
[Minerva] 
EVENT-DRIVEN PROGRAMMING STRUCTURE 


<expression> Can be any expression involving a single variable that can evaluate to true 
<commands> Can be one or more SuperBasic statements 
var Can be any variable (its value is ignored) 


The WHEN keyword appeared on a quite early version of the QL’s rom, but was never adequately 
implemented until Minerva came along. While late Sinclair roms can just about make sense of a WHEN 
structure it is foolhardy to use it as it is very unreliable. However, Minerva users can make full use of the 
structure to add an exciting new level of sophistication to their programs. 


A WHEN structure is similar to an IF structure, but instead of evaluating the expression immediately and 
taking the appropriate action, the SuperBasic interpreter will remember the WHEN expression and as soon 
as it becomes true it will nip back and execute the commands contained in the WHEN structure. This 
behaviour can be changed by executing another WHEN command referencing the same variable, or by 
issuing a “bare” WHEN command comprising WHEN followed by a variable. WHEN statements can appear 
anywhere in a program but only take effect after the interpreter has read the structure. Use CONTINUE to 
return to the line following the one that triggered the call to the WHEN code. 


You can include several simultaneous WHENs in a program provided each refers to a different variable in 
the logical expression or the variable used is declared LOCAL 


WHEN ERROR 
<commands> 
ENDWHEN 
[Minerva, some late 
Sinclalr roms] 


EVENT DRIVEN PROGRAMMING STRUCTURE 


<commands> One or more SuperBasic statements. 


WHEN_ERROR flag 
<commands> 
RETRY 

ENDWHEN 


WHEN_ERROR flag 
CONTINUE 
ENDWHEN 
[Turbo Toolkit} 


WIDTH #chan, columns 


WINDOW é#chan, width, 
height, xpos, ypos 
[SuperBasic] 

WMON mode 

[Super Toolkit Il] 

WTV mode 

[Super Toolkit Ii] 


WHEN ERROR is very similar to the WHEN structure described above, but the statements in the structure 
are executed only when an error occurs. WHEN ERROR can be used in conjunction with the SuperBasic 
keywords RETRY and CONTINUE in an attempt to circumvent the error. If you leave a WHEN ERROR 
block using GOTO or a procedure/function call the interpreter still imagines that it is inside the error 
handler, which is very likely not what you want. For a full explanation of error trapping see the New User 
Guide's forthcoming Concepts section. 


EVENT DRIVEN PROGRAMMING STRUCTURE 


flag Either 0 or 1, indicating the error level being defined 
<commands> One or more SuperBasic statements 


Turbo Toolkits WHEN_ERROR (note the significant underscore) has the enormous advantage of working 
perfectly on every QL rom variant. It also offers two levels of error-trapping. If an error occurs in a 
WHEN_ERROR 1 block, or if the end of such a block is reached without a RETRY command occuring, 
then the most recent WHEN_ERROR 0 structure will be executed, Error processing can be cancelled only 
by writing a WHEN_ERROR construct that contains just one command: CONTINUE. 


In compiled code, no line numbers and statement locations can be assumed to exist, so the RETRY 
command does not work in the conventional way. Instead, program execution resumes at the line 
following the last RETRY_HERE statement to be encountered. RETRY_HERE should be strategically 
placed at the start of several procedures so that reprocessing can commence from logical points. Note 
that the Turbo compiler has no concept of “roll-back’: it will not restore matters to exactly how they were 
when the RETRY_HERE command was first read. 


OUTPUT CONFIGURATION COMMAND 


#chan (Optional) A channel opened to a non-console device 
columns The maximum number of columns to print per line 


The WIDTH command, on early Sinclair roms at least, is not particularly reliable. It is supposed to limit the 


line width of output directed to printers to whatever is stated in the WIDTH parameter. In practice, it is 
much easier to send a printer control code. 


SCREEN HANDLING PROCEDURES 


#chan (Optional) A valid console channel 


width The width of the window in pixels (assuming high resolution) 
height The height of the window in pixels 

xpos The horizontal location of the top left corner of the window 
ypos The vertical location of the top left comer of the window 


mode 0, 4 or 512 for high resolution, 8 or 256 for low resolution 


The WINDOW command allows you to reconfigure screen windows without redefining them with the 
OPEN command. Regardless of the screen mode all co-ordinates and sizes assume that there are 512 
pixel columns on the screen. In low resolution mode, of course, only even values are significant. 


To ease the task of retuming windows to their default configuration, Super Toolkit Il contains two handy 
commands: WMON restores the initial layout of high resolution screens and WTV restores the layout of 
low resolution screens. They do not, however, change the current resolution. This is managed by the 
parameter that follows each command. 


knowing much about how it works, just as 
you can drive a car without understanding 
its engine. However, to get the most from a 
computer, as with a car, it is highly 
desirable to know something about its internal 
workings. Otherwise you may find yourself doing 
the equivalent of driving slowly uphill in top gear 
and wondering why your computer is letting you 
down. 
The Concepts section is your guide to the theory 
of computing with the Sinclair QL This Concepts 
section reaches further than the original Sinclair 
guide and tackles topics in greater depth. 
Technical terms are avoided wherever possible 
and the unavoidable ones are carefully 
explained. No prior knowledge is assumed. 
Whereas the original user guide dealt with its 
concepts in alphabetical order, the New User 
Guide's Concepts section is arranged so that 
hardware issues are covered first, followed by 
Qdos and SuperBasic topics. The first two topics 
provide an overview of the entire system from 
hardware to software. 


Towards a unified theo 


Why is computing so difficult to understand? 
Some people have a natural gift for seeing life 
from a computer's perspective, but others suffer 
from extreme forms of technophobia. Most of us 
think we will know enough to cope just as soon 
as we've mastered a little bit more detail. 
Computing is difficult for a number of reasons. 
Firstly, it is a very immature technology: we 
frequently haven't found the best way of doing 
things yet. Secondly, development in computing 
science is the fastest known to human society, 
with technologies continually leapfrogging each 
other. Thirdly, computers are a new class of brain- 
assisting machines; all other machines are there 
in some capacity to assist human musclepower. 
Fourthly, computers are chameleons whose 
purpose and appearance changes with each 
program that is loaded. Finally, and most 
confusingly, there is nothing like computing for 
contradictions, illusions and virtuality. Nothing in 
computing is what it seems. 


is possible to use a computer without 


i NEW USER GUIDE 
SECGIED 
COMO? 


It was once observed that any sufficiently 
advanced technology is indistinguishable from 
magic. To medieval people, things like railway 
engines and aircraft would fall into this category. For 
early Victorians, transistors, calculators and television 
would have been magic. For us it is fractal geometry, 
the unified theory and true artificial intelligence. 
Magic is arbitrary, fathomless and unpredictable. 
Technology, on the other hand, is predictable, 
understandable and within the control of those who 
understand it. The difference between magic and 
technology is knowledge. 


Concepts for knowledge 


Sherlock Holmes thought that the brain had a finite 
capacity for knowledge. When he was told that the 
Earth revolves around the Sun, he dismissed the 
information as valueless and tried to forget it in order 
to leave room in his mind for something more useful. 
Whether the brain’s capacity is fixed or not, it often 
seems as though it is, so what chance do we have 
of keeping up with the fastest-growing body of 
knowledge ever known? 

The answer is concepts. Information can be 
compressed into concepts that can be understood 
and remembered even though the fine detail might 
be missing. In this way, Stephen Hawking can 
explain the mechanics of the universe without 
resorting to blackboards full of equations, | can 
understand the concept of fuel injection without 
being in the least able to design a fuel injection 
system, and you can understand what makes your 
computer work without a doctorate in computing 
science or electronic engineering. 

Concepts are particularly valuable in computing 
because computer systems “exist” at many different 
levels and mutate alarmingly according to the 
perspective from which they are viewed. From the 
electron’s point of view, computers are enormous 
quantities of tiny circuits that are either switched on 
or switched off. From the hardware designers point 
of view, computers tend to be chips linked by wire 
pathways (known as buses): how precisely the 
internals of each chip go about their business is not 
particularly relevant. From the operating system's 
point of view a computer system is a central 
processing unit, a working memory area and links to 


devices, or peripherals, between which information 
in the form of integer numbers can flow. From the 
programmers perspective, a computer is a 
repository for information, often in the form of text or 
real numbers, and for the instructions that process 
the information. From the users viewpoint, the 
computer is one minute a games console and the 
next a word processor. None of these perspectives 
tells the whole story, but each depends on its 
predecessor, like the storeys of a house of cards. 


Something out of nothince 


Like Sherlock Holmes, someone concentrating on 
one of the levels tends to “hide” much of the levels 
above and beneath, so when a user views text on a 
computer screen all trace of the hardware layer has 
disappeared. There is no text on the screen, simply 
dots of light. There is. no programming language that 
people can read, but only impenetrable forests of 
numbers. There are in fact no decimal numbers, but 
only binary digits. There are, of course, no binary 
digits, but only pulses of electrical charge. 

lf you turn off a cars engine, it is still demonstrably 
a car. You can service the engine, sit in the seats, 
polish the paintwork. You can release the handbrake 
and push it around. Switch off a computer and it's a 
doorstop. The computers marvellous edifice of 
abstraction upon abstraction collapses back into its 
component parts, like a soap bubble, literally as if it 
had never been. Computers never learn anything, 
they never get better at anything, and they never 
profit from experience. Even computer programs that 
log previous behaviour never get any better at 
interpreting it. 

Computers are real-life equivalents of Doctor 
Who's Tardis: their external and internal dimensions 
are entirely contradictory. No other machine ever 
invented has this capacity to exist at several different 
levels and take on such different appearances at 
each level. In the computer, things that appear to be 
significantly different physically, such as a microdrive 
cartridge and a random access chip, might at some 
level become completely indistinguishable. Things 
that are physically similar, such as floppy diskettes, 
might be readable on one type of computer and 
completely unreadable by another. Something made 
up of many things, such as the QUs random access 
memory which is spread across several chips, might 
actually be one (supposedly) seamless whole. It all 
depends on the level at which you look at it. 


Appearance is misleading 


Just as with the Tardis, size is almost always 
misleading. Physically, the largest chip in a QL is the 
central processing unit, but its internal capacity is 
dwarfed by the storage ability of the much smaller 
random access memory chips. Double density, high 


density and extra density diskettes all share exactly 
the same dimensions, but each has double the 
storage capacity of its predecessor. A physically large 
computer, such as an IBM 286, might have less 
storage capacity and operate more slowly than the 
smaller QL Even when its “true” internal capacity is 
measured, an IBM PC often uses its memory in such 
a way that a QL with much less memory might 
actually have room to store more information. 

To cap it all, appearances can be doubly deceptive. 
A computer might look like a QL on the outside, but it 
might be runnning a program (called an emulator) 
that makes it think that it is a Sinclair Spectrum on 
the inside. You can fool an Atari ST into thinking that it 
is a QL and even buy an expansion card for an IBM 
PC that, to all intents and purposes, it really is a QL 
To return the compliment, a QL can be convinced 
that it is an IBM PC. 

It is also difficult to determine the extent of a 
computer system. Does it include peripherals, such 
as printers and monitor screens, or not? If a floppy 
disk drive is a peripheral because it is in a separate 
box and linked by cable, is a microdrive a peripheral 
even though it is physically inside the computer 
casing? The QL has a keyboard on top of its casing, 
but can also have an external keyboard added: are 
they both peripherals? Most people understand 
keyboards, disk drives, monitors and so on to be 
“devices” and thus peripheral to the computer proper 
even if they are integral to the computer case, but 
having gone down that route where do we stop? Is 
random access memory a peripheral or part of the 
computer? Is the central processing unit “a computer 
on a chip”? Is there a better answer than “it 
depends”? 


Working through the layers 


Even when we tie down the computer so that it is a 
QL on the outside and a QL on the inside, it can be a 
word processor, a number-cruncher, a golf game ora 
chess player - or all these things at once. Computers 
are electronic chameleons employing layers of 
abstraction to turn millions of tiny, simple electronic 
circuits capable only of being “on” or “off’ into, for 
instance, sufficient calculating power to outwit all but 
the very top human players at chess. And then, as 
soon as they are turned off, they forget completely 
that they have ever done it. 

To make sense of these contradictions we must 
take a journey through the layers, beginning with the 
physical components and ending with the high-level 
programs, from what the Americans call “close to the 
iron” to what is becoming increasingly familiar as 
“virtual reality”. 


Next month Mike Lloyd starts to analyse the rock 
bottom concepts of computing. 


Simon Goodwin tack- 
les serial mouse 
interrupts with 
68000 assembly lan- 
guage. 


is issue completes the 

source listing for the DIY 

Toolkit mouse extensions, 

and includes full assembled 

code to suit PC Serial mice with three 

buttons. 

| shall explain the exact format of 

information sent by the mouse, and 

show how it is converted into stan- 

dard pixel co-ordinates and button 

signals which can easily be read from 
SuperBasic. 


Assembly Code 


Listing One completes version 1.6 
of the DIY mouse handler, with code 
for the remaining SuperBasic com- 
mands and the interrupt driven han- 
dlers that read signals from the 
mouse and store them for your pro- 
gram to read. 

The first section of the assembly 
listing implements four new 
SuperBasic commands, discussed 
last month. The code is very straight-forward as they all work 
the same way, reading two integer parameters with the 
CAGTLIN vector and storing them among the mouse drivers 
own variables. 

Qdos calls its polled interrupt handlers fifty times a sec- 
ond, unless interrupts are temporarily prevented by network, 
disk or microdrive accesses which demand the processors 
full attention. 

The DIY Mouse handler is labelled SERVER, and comes 
after the code for the commands. It starts by checking to see 
if the serial port is in use, If not, it returns at once. 

Otherwise it reads bytes from the serial input queue until 
there are no more left. After processing each byte the han- 
dler returns to NEXT_BYTE to pick up another. Address reg- 
isters A1, A2 and A4 are set outside the loop and not modi- 
fied thereafter, to save time when processing several bytes at 
once. 


NOORKIT 


Variables 


Qdos sets register A3 to point eight bytes before the inter- 
rupt linkage when any interrupt handler is called. The LEAL 
instruction in my code points A4 at the variables used by the 
mouse driver, so later lines can find them easily from their 
offsets. 

The Table shows the variables and their meanings. 
Variables 10 to 13 are only used in the version of the handler 
with keyboard emulation. Each variable is a word, normally 
an integer in the range 0 to 32,767. 

The serial ID occupies two words; the first is the channel 


tag, and the second is the 
number in the Qdos chan- 
nel table. Both are zero if the 
channel was already open 
when the PTR_ON com- 
mand was issued. 

The eighth word holds a 
byte value, corresponding to 
the SYNCH% function, 
which cycles from 0 to 3 or 
5 as each byte of the mouse 
message is received and 
checked. The other byte in 
this word is only used in the 
Microsoft two-button version, 
when it stores the first byte 
of each message so that it 
can be used to extend the 
range of the X and Y delta 
bytes. 

You can read some of 
these variables directly from 
SuperBasic extensions. For 
instance PTR_X% and 
PTR_Y% read LATEST_X 
and LATEST_Y respectively, 
and BUTTON% reads BUT- 
TON_BITS. 

The next section of the 
code differs wildly depend- 
ing on the type of mouse. 
Mouse Systems and 
Microsoft cannot aggree on 
whether rising co-ordinates 
indicate movement up or 
down, so the three-button 
code SUBTRACTS incoming 
moves from the current posi- 
tion, while the two button 
variant ADDS them. 

The code variations 
ensure that the result of a 
move is the same to 
SuperBasic, regardless of 
the model. If you represent 
the mouse position with a 
pointer drawn with pixel co- 
ordinates on the screen, 
mouse movements shift the 
pointer the same way - as 
long as you have the but- 
tons pointing away from you 
and towards the screen. 

Thankfully both firms 
agreed that values should 
ascend from left to right, but 
even that may confuse 
Arabic and Hebrew writers, 
who scan the opposite way 
- as digits are still written in 
arithmetic. Standards are 
tricky things. 

The two button mouse 
moves the button bits to the 
right place with a shift and 
an OR instruction, but this 


would be more complicated 
for three buttons, especially 
as they do not come in the 
standard order we want to 
hold them in BUTTON_BITS. 

The program uses a small 
table, labelled 
BUTTON_CODE, to translate 
the three incoming bits into 
a BUTTON% value. The bits 
are inverted as well as shut 
fled, as Mouse Systems set 
a bit to one UNLESS the cor- 
responding button is 
pressed. 

Tables are wonderful 
things, and can often do 
several jobs at once in pro- 
gramming. They are also 
easier to test, modify and 
prove correct than algo- 
rithms. If your program 
needs to transform one 
short pattern of bits into 
another, it’s probably best, 
and almost always fastest, to 
use a table. 


Loose Buttons 


| should explain that the 
buttons are numbered the 
same way regardless of how 
many there are. The bits are 
in different places depend- 
ing on the type of mouse, 
but the DIY Toolkit mouse 
driver hides such differences 
from the programmer. 

As far as SuperBasic is 
concerned, the leftmost but- 
ton is button one and the 
right, button is button two. If 
both buttons are pressed, 
BUTTON%(0) returns three. 
The middle button only 
appears on a Mouse 
Systems mouse. Contrary to 
my last article, this is button 
three, ignored in Microsoft 
mouse mode. If this button 
is pressed it adds four to the 
result of the BUTTON%(0) 
function. 

You can use this function 
to derive a QL Mode 8 
colour, between zero and 
seven, from the combination 
of buttons held down as the 
mouse moves, This soon 
gets tiring if you're trying to 
draw a multi-coloured pic- 
ture, so it's better to show 
the colours in a reserved 
area of screen and let the 
user select them by pointing 


Vol. 2 Issue. 11 Sinclair QL World 1 9 


* Qi WORLD D 


TY TOOLKIT - 


ASSEMBLY CODE MOUSE/POINTER DRIVER 


Links SuperBASIC to a PC serial mouse; source listing part 2 
Suits Mouse Systems 3 button and Microsoft 2 button rodents 
Version 1.6, © Copyright November 1993, by Simon N Goodwin. 


PTR_MAX, PTR_INC, PTR POS etc. share most of their code 
They differ only in the address for the stored value in A4 


point_inc 


Fo 
point_box 


ca 


point_max 


* 


point_at 
setwords 


exit 
- 


* This is the clever 


* 


server 


next_byte 


* 


* 33333333333333333333333333333333333333333333333333333333333 
¥. 


* 


y_byte 


in_yrange 


clear_yout 
check_cycle 


clear_sync 


* 


button test 


* 
button_code 
* 


bsr.s 
addq. | 
bra.s 


jea.] 
cmpa. | 
bhi.s 


bsr.s 
addq. | 
bra.s 


bsr.s 
movea.w 
dsr 
bne.s 
subq.w 
bne.s 
move.w 
bmi.s 
swap 
move .w 
bmi.s 
move. | 
rts 


move. 1 
beq.s 
movea. | 
move .w 
Tea. ] 
jsr 
bne.s 


ifeq 
ext.w 
addq.b 
move.b 
subq.b 
beq.s 
btst 
bne.s 


move .w 
sub.w 
bmi.s 
move .w 
cmp.w 
bis.s 
move.w 
move.w 
bra.s 
clr.w 
subq.b 
bne.s 
clr.b 
bra.s 


moveq 
and.b 
cmp .b 
bne.s 
moveq 
and.w 
move.b 
move.w 
bra.s 


dc.b 


find_pos 
#step_x,a4 
setwords 


16(a3),a3 
a3,a5 
bad_param 


Ignore first two parameters 
Error if A3>A5 
find_pos 


#1limit_x,a4 
setwords 


Skip first two co-ordinates 


find_pos 
$112.w,a2 
(a2) 
bad_exit 
#2,d3 
bad_param 
O(al,a6.1),d 
bad_param 

dl Move X value to high word 
2(al,a6.1),d1 Check Y 

bad_param 
dl, (a4) 


Vector gets words 


Test for two parameters 
Reject otherwise 
Check X 


Store checked value 
Return zero DO error code 


bit - the MS/PC mouse interrupt server 


ser_pointer(a6) ,d0 

exit 

d0,a2 Find SER2 input queue 
$E2.w,al 10.QOUT vector 
8+prefix(a3),a4 Find variables 

(al) 


exit Nothing to process now 


buttons-3 
dl 
#1,synchro(a4) Count bytes 1 to 5 
synchro(a4),d0 
#1,d0 
button_test 
#0,d0 

x_byte 


Use 0 to 4 internally 


Is this a Y delta? 
No, it’s an easy X 


* Process the third and fifth bytes, the Y delta’s 
* 


latest_y(a4) ,d2 
dl,d2 
clear_yout 
limit_y(a4),d1 
d1,d2 

in_yrange 
d1,d2 

d2, latest_y(a4) 
check_cycle 
Jatest_y(a4) 
#4,d0 

next_byte 
synchro(a4) 
next_byte 


Limit minimum to zero 


Set current Y to limit 


Is this the fifth byte? 


Await next sequence start 


#-8,d0 
dl,do 
#128,d0 
clear_sync 


Mask out three button bits 


No, so keep waiting 

#7 ,d0 Mask in three button bits 
d1,do DO.W is just the buttons 
button_code(pc,d0) ,d0 

dO, button_bits(a4) 

next_byte Button code converted 


7,55350,56,452,0 


i Apply second and fourth bytes, the X deltas 


x_byte 


move.w 
add.w 
bmi.s 
move .w 
cmp .w 


latest_x(a4),d0 
d1,do 
clear_xout 
limit_x(a4),d 
d1,do 


Don’t move left of zero 


Z 0 Sinclair QL World Vol. 2 Issue. 11 


Skip first four co-ordinates 


Are the others as expected? 


and clicking. 

Most mouse-driven opera- 
tions need only one button, 
which saves the user the 
trouble of working out which 
to press; indeed, Apple Mac 
users get no choice in this 
regard. 

The commands were dis- 
cussed last month, so | shall 
not repeat their details here. 
Arcwind can supply the 
back issue if you missed it; 
you may also find the previ- 
ous one (Volume 2 number 
9) interesting as it includes 
three SuperBasic prototypes 
for the mouse drivers. 


Protocol 


Further investigation 
reveals that the three-button 
mouse returns five bytes of 
information at a time. The 
first is easily recognised as 
only three bits ever change - 
these are the button signals. 
The MOUSE_KEYS program 
in issue 9 did not count the 
bytes, but reset itself to the 
start of the sequence when- 
ever it found a plausible but- 
ton byte, and looked for X 
and Y changes thereafter. 

It turns out that the three 
button mouse sends four 
bytes of directional informa- 
tion for every one byte of 
button data. The SuperBasic 
version works fine - at least 
on Hermes - as it treats 
bytes as X and Y moves 
alternately till it runs across a 
new button code. Button 
codes look like extremely 
big negative moves, so they 
are easily distinguished. 


Resynchronis 
-ation 


The machine-code version 
can go faster by reading the 
serial input queue directly, 
but it can still get out of step 
if Sinclair's old IPC loses 
bytes on their way from the 
mouse to Qdos. This is par- 
ticularly likely if the QL is 
busy with a device and can- 
not read serial bytes for a 
while. They pile up in the 
8049 co-processor, and 
soon overflow. 


The DIY mouse handlers 
check the format of the first 
byte and if it is inplausible 
they discard it and wait for a 
valid one. This means that 
the handler re-synchronises 
itself at the start of the next 
complete message. 

Both handlers jump to the 
code labelled CLEAR_SYNC 
when looking for the start of 
a new message. The two 
button version can also veri- 
fy vertical and horizontal 
moves; if it finds a button 
signal when it expects a 
move, the RESYNCH routine 
sets SYNCH% back to one, 
the start of the message, 
and gets on with processing 
the button code. The bit pre- 
fix is the same for both X 
and Y bytes, so there's still a 
risk that the driver will mis- 
interpret a Y byte as an X 
move if you’re unlucky and 
only the second byte is lost. 

It's not perfect, but it works 
most of the time; if you want 
perfection, get Hermes, or a 
real serial port rather than 
Sinclairs version, which is 
generally fine for output, but 
not so good at input. 


Re-assembly 


Listing One was devel- 
oped and tested with 
HiSoft’s Devpac 2 assem- 
bler. Symbols like BUTTONS 
were set up at the start of 
the listing, and control con- 
ditional code for the two and 
three button versions. Don't 
try to assemble this listing 
on its own. 

Append the code in 
Listing One to last month's 
source, and load the result 
into your own assembler if 
you want to modify or exper- 
iment with the full source. 

It ends with the serial 
device name, which 
depends on the chosen 
port, and the table of com- 
mand and function names. 
These come after the code 
to make it easier to change 
them without re-assembly, 
but it is wise to re-assemble 
the entire source if you want 
to change the length of any 
names, and you can’t 
change the serial port with 


in_xrange 


clear_xout 


* 


bis.s 
move.W 
move .w 
bra.s 
clr.w 
bra.s 

endc 


in_xrange 
d1,do 

dO, latest_x(a4) 
next_byte 
latest_x(a4) 
next_byte 


Set current X to limit 


* 22222222222222222222222222222222222222222222222222222222222 
* 


byte_one 
* 


ifeq 
moveq 
move.b 
addq.b 
move.b 
moveq 
cmp.b 
beq.s 
bpl.s 
move.b 


buttons-2 
#0,d2 
d1,d2 
#1,synchro(a4) Count bytes 1 to 3 
synchro(a4),d0 
#-64,d1 

#2,d0 

byte_two 
byte_three 
d2,initial(a4) Save byte 1, used later 


Clear high bytes 


Mask for top two bits 
Switch three ways 


* Check & process first byte of message, button code 192+ 


* 


button_test 


only_one 


* 
yresynch 


byte_two 


clear_sync 


* 
valid_x 


in_xrange 
clear_xout 


* 


* Process Y 
* 


byte_three 


in_yrange 


* 


clear_yout 


* 
stream 


and.b 
cmp.b 
bne.s 
moveq 
and.b 
Isr.w 
bec.s 
or.b 
move .w 
bra.s 


move .b 
move.b 
bra.s 


and. 
cmp. 
beq. 
bec. 
ele. 
bra. 


and.b 
moveq 
and.b 
Isl.w 
or.W 
ext.w 
move .w 
add.w 
bmi.s 
move .W 
cmp .w 
bis.s 
move.W 
move .w 
bra.s 
clr.w 
bra.s 


delta 


and. 
cmp. 
beq. 
bec. 
bra. 


and.b 
moveq 
and.b 
Isl.w 
or.wW 
ext.w 
move .w 
add.w 
bmi.s 
move .W 
cmp .W 
bis.s 
move.w 
move.w 
bra.s 


clr.w 
bra.s 
endc 


dc.w 


d1,d2 

dl ,d2 
clear_sync 
#48,d0 
initial(a4),d0 
#5,d0 

only_one 

#2,d0 Flag button 2 in bit 1 
d0,button_bits(a4) 

next_byte 


Check top bits only 

Are others as expected? 

No, so keep waiting 

Mask only valid button bits 


Shift to bit ‘0 and carry 


#1,synchro(a4) Reset count to one 
d2,initial(a4) Treat new byte as first 
button_test 


d2,dl 
#128,d1 
valid_x 
resynch 
synchro(a4) 
next_byte 


Check top bits 


Await start of sequence 


#63 ,d2 
#3,d1 
initial(a4),d1 Dl is two MS bits 


D2 is six LS bits 


D1l.W is signed X delta 
jatest_x(a4),d0 
d1,d0 
clear_xout 
limit_x(a4),d1 
d1,d0 
in_xrange 
d1,d0 
dO, latest_x(a4) 
next_byte 
do Zero 
in_xrange 


Don’t move left of zero 


Set current X to limit 


d2,d1 
#128,d1 
valid_y 
resynch 
clear_sync 


Check top bits 


#63,d2 

#12,d1 

initial(a4),dl 
Dl is two MS bits 


D2 is six LS bits 


-D1.W is signed Y delta 
latest_y(a4) ,d0 
d1,d0 
clear_yout 
limit_y(a4),dl 
di,d0 
in_yrange 
d1,d0 
dO, latest_y(a4) 
clear_sync 


Stop at zero 


Stop at limit 


Jatest_y(a4) 
clear_sync 


oO 


* 


define 6 


0 
4 


.W 
-W 
-b 
.W 
a) 
.W 
-b 
-W 
<b 
.W 
-b 
-W 
-b 
.W 
-W 
-W 
-b 
-W 
-b 
-W 
-b 
-W 
-b 
-W 


0 


out re-assembly. 

The only unusual features 
are the conditional assem- 
bly, discussed last month, 
and word sizes after vector 
addresses like $112.W 
(BV.CHRIX) and $E2.W 
((O.QOUT). Remove the sec- 
ond W on the line if your 
assembler objects to it. At 
worst, it will cost you an 
extra two bytes of code if the 
long address of the vector is 
used; it will still work fine. 


Loading 


Listing Two generates 
code for the three-button 
Mouse Systems PC serial 
mouse handler for SER2. It 
reads the code from Basic 
DATA statements at the end 
of the listing, stores the code 
in memory, then writes it to a 
file after checking. These 
three commands load and 
link the resultant 
MOUSE3_CODE file: 


xpoint-* 

6, ’PTR_X%’ 
ypoint-* 
6,’PTR_Y%’ 
button-* 

7, 'BUTTON%’ 
synch-* 

6, ‘'SYNCH%’ 


"SER’,’0’+ser_port, ‘IR’ 


Six procedures 


point_off-* 

T, 'PIUR_OFF:: 

point_on-* 

6,’PTR_ON’ 

point_box-* 
10,’PTR_LIMITS’ 0 
point_at-* 

7,’PTR_POS’ X% , Y% 
point_max-* 
7,'PTR_MAX’ X% 
point_inc-* 
7,’PTR_INC’ X%., Y% 


, Y% 


Four functions 


X=RESPR(688) 

L686 ¥ | & 6 
FLP1_MOUSE3_CODE,X 
CALL X 


This sequence of com- 
mands adds the extensions 


PTR_ON, PTRUOFE 
PTR_POS, PTR_MAX, 
PTR_INC, PTR _LIMITS, 
SYNCH%, BUTTON%, 


X_PTR% and Y_PTR% to 
SuperBasic. Plug the mouse 
into SER2, then use these 
commands to initiate mouse 
communications: 


BAUD 1200 
PTR_ON. 


If you want to stop the 
mouse handler, perhaps to 
use the serial port for some 
other purpose, enter: 


PTR_OFF 
If you change the baud 


rate remember to restore 
BAUD 1200 before you re- 
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start the mouse handler. 

Notice that the three-button code file is shorter than the 
Microsoft serial mouse version. There are more buttons, and 
Mouse Systems messages are longer, but there is no need Three button SERIAL MOUSE SuperBASIC DRIVER LOADER 
to shuffle bits between data bytes to get the co-ordinate ibe pEMaek sinclate cx world eee Calber 0 3 


updates. 10 REMark by Marcus Jeffery & Simon N Goodwin 
. if ae don't like the names of the commands and func- CLS: RESTORE : READ space: start=RESPR(space) 
tions you can patch or ALIAS them, as | have explained in PRINT "Loading Hex..." : HEX LOAD start 
past columns. If you need to remove them from the name 150 INPUT "Save to file...";f$ 
table, with a routine like FORGET from DIY Toolkit Volume B, SEETES Berge haels saES SPOR 
make sure you turn them off first with PTR_OFF, or the inter- DEFine FuNction DECIMAL(x) 
‘ ' 1 RETurn CODE(h$(x))-48-7*(h$(x)>"9") 

SH oe be left running and you will no longer be able to rer Ak pate 

The processor time used by the driver is almost unmea- DEFine PROCedure HEX_LOAD(start) 
surable when the mouse is still, but it can slow the machine Ee EE rset 
down by a few per cent while the mouse is moving fast and READ hS a: 
sending many bytes per second. oe! Ria? i eee ee lendabee digits 

A . +, ’ (h$) MOD 2 

A set of DIY Toolkit mouse drivers is included in the latest PRINT"Odd number of hex digits in: ";h$ 
volume on disk, available by post from former Quanta editor 
Dr. Bill Fuggle. Volume | includes the SuperBasic prototypes, "= 1 TO LEN(h$) STEP 2 
wiring details, example programs, assembler source and = DECIMAL(b) : 1b = DECIMAL(b+1) 
binary code for “Mouse Systems PC” and “Microsoft” serial IF hb<0 ,OR;hb>15 OR 1b<0 OR lb>15 

* . . ‘ 4 PRINT"T11 de Thi digit. int, “sbs ¢ 

mouse drivers to suit either serial port. These come in two END IF eee ae ; 
versions, one of which sends key signals so it can be used POKE Startroyeaal@abtuy 
with programs like Quill, Abacus, Turbo and editors which yee byte ee a 
normally only work with cursor keys. END FOR b had 

DIY Toolkit volumes cost three pounds each on disk or en Ra hsb lai nal 
microdrive cartridge, and come with printed documentation if IF check <> checksum 
you order two or more. Twenty four volumes are available as "Checksum incorrect. Recheck data.":STOP 
from DIY Toolkit, 86 Lordswood Road, Harborne, Birmingham Pirin Wenn aouesak aacmatesndea ls Meseane 


B17 9BY. Please make cheques payable to DIY Toolkit, and 
send a stamped selfaddressed envelope if you would like 


further details. 0 REMark Space requirements for the machine 
588 


END DEFine HEX_LOAD 


"43FA01DA34780110","4ED2616267507220" 

"740070184E414A80","665645FA012C214A" 

Next Issue "000421470008217C","01FFOOFF0010217C" 
"0006000A00142C08","70004E414AA8009C" 

7 ‘ : . "661641FA01907200","760170014E424A80" 
Next issue features the final part of this project, with add- . ie eloarzaea3ae001ct fe es 
on code to let the mouse handler generate key-presses, a TA "4E7520462E007019" , "4E4120074E75617A" 
H H inti "4E7561FA6B70202C" ,"0010670620407002" 

few extra features, and a checklist for reliable pointing. 2 VARA ALRGE FEA GDLD" AAD APT LOAORREDTS" 
"01124E92667C5343" ,"66763631E800614A" 
"382C000C67364A43","6732B67C00036260" 
"5343070466267800","6022612E7800182C" 
"QOOE600C7A006002","7A02611E38345800" 


Table: Internal Mouse Variables "72023478011A4E92" , "55AE0058226E0058" 
we La este! fas Wel "3384E80078037000","4E7570004E412E3C" 
ar 4449593149E8003C","2014670E2840BEAC" 
Name Word Number Description "000866F449ECO00C" , "4E75588F70F94E75" 
? eri "70F14E7561D4508C", "601047EB0010BBCB" 
Latest_X 0 Current X co-ordinate "62EE61C6588C6002","61C0347801124E92" 
Latesty 1 Current Y co-ordinate nesn0ss43¢eDh3231",vze906@D440412231" 
UimitX 2 Fight margin limit SH et en eae 
Limit_Y 3 Top margin limit "342C000294416B10" ,"322C0006B4416302" 
; "3401394200026004", "426C0002590066C8" 
Step_X 4 Counts per horizontal move "422CO00E60C270F8" , "CO001B03CO08066F0" 
"7007C041103B0008","3940000C60AA0705" 
Step_Y 5 Counts per vertical move \ "030106040200302C","0000D0416B10322C" 
: ; "0004B04163023001","39400000608A426C" 
Button_bits 6 Bits shadow each button "0000608400065345",,"523249520006FE94" 
"075054525F4F4646" , "FE22065054525F4F" 
Synchro 7 Input byte number 1 to 3/5 "4EOOFF280A505452",, "5F4C494D49545300" 
a ; rash "PF28075054525F50" ,"4F53FF1807505452" 
Initial v4 Microsoft initial byte "SF4D4158FF000750","54525F494E430000" 
; ; "0004FEA206505452" ,"5F582500FE9C0650" 
Serial_ID 8+9 Zero or serial tag & channel "'54525F592500FE58" "07425554544F4E25" 
Drift _X 40 Accurnularec ener "PE7A0653594E4348" "25000000", "*", 44348 
Drift_Y 11 Accumulated Y drift for keys 
Key_flag 12 Set to request key queueing 
Wrap_flag 15 Set to allow wrap at edges 
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Neural 


Networking 


Dr Steven Wilcox’s QL works on a new field of artificial intelligence. 


his article aims to intro- 

duce a new type of 

computing that can 

only be simulated on a 
digital computer like the QL This 
is neural computing, a relatively 
new area of research (in its cur- 
rent form) in the arena of artifi- 
cial intelligence (Al). Artificial 
neural networks (ANN) resulted 
from an investigation into the 
usefulness of a set of simple 
processing units connected 
together in different ways. The 
result has been the this new 
form of computing, which has 
recently found its way out of the 
Al laboratory and into applica- 
tions as diverse as stock market 
forecasting to speech recogni- 
tion. Firstly, | would like to recap 
some of the short history of Al 
or, More correctly, machine 
learning. 

Machine learning (ML) has 
played a central role in Al from 
the start of research into the 
field, although main thrust of Al 
research has deviated from this 
area with the arrival of such sig- 
nificant develooments as prob- 
lem solving, theorem proving, 
robotics and expert systems 
(ES), But recently ML has again 
started to play a significant and 
increasing part in the develop- 
ment of Al. For instance, early 
work on perceptrons (which are 
simple neuron-like processing 
units) suffered some setbacks 
because of an inability to solve 
non-linear functions, presented 
by Minsky and Papert [1]. 
However, there has been a 
resurgence in scientific and 
media interest due in part to the 
work of Hopfield [2], Ballard, 
Hinton and Sejnowski [3] who 
have played a large part in the 
development of ANNs with hid- 
den layers (layers of neurons 


that are not directly connected 
to the input or output of the net- 
work) capable of learning to 
recognise non-linear functions. 


How to learn? 


The ability to learn, to adapt 
and to modify behaviour has 
been regarded by some as an 
exclusive property of organic 
beings, while some people 
argue that only human beings 
possess learning capabilities 
and intelligence. It is probable 
that the ‘ability to learn’ is a ore- 
requisite for any form of intelli- 
gence and, in order to check for 
intelligence, a test has been pro- 
posed by Turing [4]. In this test a 
human being is asked to com- 
municate, through a terminal, 
with two or more other opera- 
tors one of which is the artificial 
system. If 
the human 
being can 
not tell 
whether the 15 
answers to 
his ques- 
tions were 
from the 
system or 
the other 
human then q) 
the artificial 
system 
could be fav) 
regarded as $y 
possessing . 
true intelli- 
gence. 

Early 
attempts at 
applying this 
test have 
proved how 
difficult it will 
be for a 


“ 
iG 


network layout 


7 
a HO 


Figure one: The neural 


machine to achieve intelligence 
defined in this way. A computer 
program known as ELISA [5,6,7] 
achieved partial success until 
the person communicating with 
it worked out how it was com- 
posing its answers. In reality, the 
program does not ‘understand’ 
the words in the sentence but 
simply examined the sentence 
for key words to operate on, or 
used one of a set of standard 
replies. 


Neural networks 


One approach to Al, as briefly 
mentioned earlier, is the artificial 
neural network (ANN). It is not 
clear whether the ANN 
approach is likely to achieve 
success as defined by Turing, 
but it has merits of its own 
where specific solutions are 
required to specific problems. In 


Ts of the use of ANNs 
in this article, some of the 
features of both real 
neural networks and 
ANNs are outlined below. 
Two of the main com- 
ponents of the brain are 
the cerebellum, and the 
cerebrum and cerebral 
cortex, which surrounds 
it The cerebral cortex 
has a surface area of 
2000 sq cm, is approxi- 
mately 3 mm thick, and is 
composed almost entire- 
ly of a layer of neurons 
six-deep. It contains 


about 100 billion neurons, with 
the central nervous system as a 
whole containing perhaps as 
many as 1000 billion. It is 
thought that the cerebrum and 
cerebral cortex perform most of 
the higher-order functions of our 
existence such as creativity and 
reasoning, with the cerebellum 
performing lower level functions 
such as the control of breathing. 
A biological network is con- 
stantly changing as the organ- 
ism learns new skills, and it is 
thought that this is partly 
achieved by changing the 
strength of the connections 
between neurons. As well as the 
strength of connections increas- 
ing and decreasing (the strength 
of the connection between two 
neurons is known as its 
“weight’), connections appear 
and disappear throughout the 
life of the organism. In fact, neu- 


for Letter | 


for Number 


rons can die if they do not make 
useful connections and in the 
first few years of life around 15% 
of neurons die because they do 
not make useful connections 
with other neurons through 
nerve fibres called axons. 


Connection 
changes 


In a similar manner, the con- 
nections in an ANN constantly 
Change as the network learns, 
and these too can appear and 
disappear as the strength of 
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connection between “neurons” 
increases Or approaches zero. 

The neuron makes connec- 
tions with other neurons and 
communicates through the axon 
(the main communication fibre) 
and dendrite (the connection to 
the neuron). Communication is 
achieved by emitting electrical 
pulses (termed “firing”), around 2 
milliseconds in duration and 
100 millivolts in amplitude. 
When the sum of the input 
weights (the pulses from other 
neurons) the neuron receives 
exceeds a certain excitation 
level it will fire itself 

An artificial network doesn’t 
emit pulses to communicate 
with other neurons. Instead, it 
emits a number between O and 
1 that is a function of the inputs 
it receives from other neurons, If 
the sum of the inputs, when it 
has been weighted in a particu- 
ar manner, exceeds a preset 
evel then the neuron will emit 
the appropriate number. The 
orecise procedure is described 
ater in this article. 


ANNs 


Artificial neural networks 
(ANNs) are a simplistic repre- 
sentation of this type of biologi- 
cal network. Usually they consist 
of a set of inputs with a series of 
hidden layers followed by a set 
of outputs. There are two broad 
classes of artificial neural net- 
work. The first class uses distrib- 
uted representation, where the 
total knowledge (for every prob- 
lem to be solved) of the network 
is distributed across the entire 
network. Figure one shows an 
example of such a network. In 
this example every neuron in 
the input layer is connected to 
every neuron in the middle (or 
hidden) layer, which is in turn 
connected to every neuron in 
the output layer. 

The second method uses a 
localised representation, where 
single processing units, or small 
groups of units, hold the know- 
edge required to solve a single 
problem. This type of network 
will not be demonstrated here. 

A network learns to discrimi- 
nate between classes of pat- 
terns from an input domain in a 
holistic manner. The network is 


presented with sets of features 
(usually one-dimensional arrays 
of data collected from the prob- 
lem) that are representative of 
the instances of each class, cor- 
rectly labelled, and the ANN is 
trained to recognise these. It 
does this by readjusting internal 
weights in a fixed network topol- 
ogy via a learning algorithm, so 
that the weights are optimised to 
the entire training set These 
algorithms, in essence, calculate 
the amount of credit each active 
processing unit deserves by 
comparing the output of the sys- 
tem with the correct response. 
Current ANNs do not accu- 
rately represent the biological 
equivalent, but rather 
exploit ways in which 
it is possible to con- 
nect a set of simple 
processing units. The applica- 
tion of the approach to real 
problems, such as word recog- 
nition, has shown that the ANN 
has the ability to recognise fea- 
tures more accurately from the 
input domain than has previous- 
ly been possible using the 
Expert System-type approach 
[2]. 


An ANN for the 
QL 


The network that I'm 
going to present and 
use is of the simple 
feed-forward type, 
trained by a backpropagation 
algorithm that ensures that all of 
the network is involved in the 
storage of knowledge. Figure 
one shows a diagram of the lay- 
out of the network and the con- 
nections of each neuron. 

The reason for this choice of 
network is relatively simple. The 
“feed-forward” tyoe of network 
has been shown to perform well 
in other situations and is relative- 
ly well developed. The training 
algorithm, “back-propagation” 
has been developed for this 
type of network and has similar- 
ly been proven. 

The network functions by the 
combined effects of individual 
neurons which compute a 
weighted sum of their inputs to 
give an excitation (Sepsilon$). 
This is then used in a “sigmoid” 
function (the excitation function) 
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of the form: 


1 


ils a 


This type of function makes 
the neuron more “decisive” as 
the state of the neuron will 
switch from inactivity to activity 
very quickly around the central 
point of the functionFor each 
neuron the training rule is to: 


a) Present the network with 
the input The neuron output is 
given by calculating: 


o(i) = Bw(j).t(9) 


Where: 


oti) is the output of the ith neu- 
ron 

W(i) is the weight of the jth 
input to the ith neuron 

i(j) is the input to the ith neuron 
on the jth input line 


b) For each neuron compute 
the error, which is given by: 


A(?) = [o(t) — do(?)].F"(e) 


Where: 


(Ai) is the error of the ith neu- 
ron 

o(i) is the actual output of the 
ith neuron 

do(i) is the desired output of 
the ith neuron 

fe) is the derivative of the exci- 
tation function 


c) Adjust the weight w(i) by an 
amount given by k(A)(i).i(j), where 
k is a constant that determines 
the rate of learning. 

This training algorithm works 
for single layered networks but 
a bit more work is required for a 
multi-layer network as, this 
method does. not allow the hid- 
den layers to be trained. If these 
layers are ignored in the training 
algorithm then they will not 
assist in the decision making 


process and are therefore 
redundant 


Hidden layers 


Hidden layers can be utilised 
by computing the error for each 
neuron in the output layer, (A\i), 
and associating with each hid- 
den unit in the layer below a 
proportion of the error of each 
output neuron to which it is con- 
nected. This proportion should 
obviously be the strength of the 
connection between the hidden 
neuron and the output neuron. 
This means that the hidden neu- 
ron's error will be a weighted 

sum of all the errors of all 

the output neurons to 

which it is connected, 

weighted again by the 

derivative of the excitation 
function. This approach is then 
propagated back through the 
network, a layer at a time, until 
the input layer is reached. 
Hence the term “back-propaga- 
tion”. 

If each input, as in Figure one, 
is used for character input and 
a number of different neurons 
are used to represent different 
recognised characters it is pos- 
sible to train the network to 
recognise typed letters by the 

state of its inputs (the let- 

ter) by repeatedly pre- 

senting random selec- 

tions from the character 

set and telling the net- 
work which letter this is. If the 
training set is representative 
then the network can be pre- 
sented with new data from the 
keyboard and asked to make a 
prediction as to which key the 
data comes from. The output of 
each neuron will then be repre- 
sentative of the probability of the 
letter being in that region. 
Obviously, the higher the proba- 
bility the more certain of its 
choice of letter will the network 
be. If the network cannot decide 
on the letter then this will mani- 
fest itself as similar lower proba- 
bilities over several or all output 
neurons. 


SuperBasic ANN 
code 


The ANN code and theory that 
| have presented is based on 


the Hopfield (a researcher who 
has been very active in this 
area) network with a back-prop- 
agation training algorithm. The 
network is supervised during 
training, so is only of use where 
the supervisor knows what the 
output of the network should be 
for the training set of data. When 
the network has been trained, it 
then should be possible to pre- 
sent the network with new 
examples of the problem and 
with a little luck, and if the exam- 
ples have been properly select- 
ed, the network should classify 
them correctly. 

As an aside, a recent television 
programme contained a good 
example of a network that had 
not been trained on representa- 
tive data The example came 
from the US military where they 
had been training a network to 
recognise tanks in various types 
of undergrowth. They had tanks 
in open fields, partly hidden by 
bushes, groups of tanks, etc. 
The training went well, but when 
they came to test the network 
on examples that had not been 
presented previously, the net- 
work performed very poorly. 
After a small investigation it was 
found that the training data con- 
sisted of slides of tanks on 
sunny days and slides of no 
tanks on cloudy days - the net- 
work had learnt to recognise the 
difference between a nice and a 
grotty day, a possibility that had 
none of the intelligent life forms 
present had taken into consider- 
ation! This emphasises the need 
to make the training data repre- 
sentative of what you want the 
network to learn. 

In order to train the network, 
large numbers of presentations 
of each input have to be made. 
In this example around five hun- 
dred is the minimum that can be 
used. All this takes some time, 
and if you have a compiler then 
everything will be soeeded up 
enormously. The code has been 
compiled with QLiberator 3.35, 
so should compile with little 
problem with other compilers, 
although | have not been able to 
test this. It should also be possi- 
ble to run the network on a 
basic 128K QL as there are no 
large arrays and the code is not 
very big. 


Setting weights 


The code consists of five pro- 
cedures, ‘run_network’, 
“get_input’,, ‘setup_network’, 
“show_results’ and ‘train_net- 
work’ with ‘run_network’ and 
‘train_network’ being the main 
routines, Procedure ‘setup_net- 
work’ simply sets the weights of 
every connection to a random 
value between -0.5 and 0.5 so 
that the weights are set to val- 
ues that are not the same every 
time the network runs. 
Procedure ‘get_input’ randomly 
selects either the letter ‘ or the 
number *1’ from the character 
set, then determines the equiva- 
lent binary value (input vector) 
and the correct output for each 
Output neuron. (The training 
flags in the array target( is 
changed from 1 or O to 0.9 and 
0.1 as it is very difficult for the 
weighting function used to 
approach 1 and O) 

Procedure ‘run_network' takes 
the input vector and with the 
current weights calculates the 
output of the network, which is 
then used in the procedure 
‘train_network’ to propagate the 
error derivative backwards 
through the network from output 
to input whilst adjusting the 
weights to minimise the error. 
Finally, procedure ‘show_results’ 
crudely displays the results 
either while training is taking 
place or when the network is 
being tested after training is 
completed. 

When you first train the net- 
work it can appear to be a lost 
cause, as the error takes quite a 
time to reduce, at the start it may 
even increase for awhile. 
However, if you persevere and 
come back in the morning, the 
training will be completed and 
you will be able to test it with 
new input from the keyboard. 
This is where lines 1220 to 
1600 come in as they take the 
code for the letter ‘! or the num- 
ber “1', or a random pattern if 
you press any other key, and 
present it to the network. Strictly 
speaking this is not a proper 
test of the network as the test 
data and the training data are 
identical and, it would be very 
disappointing if the network 
failed. This is however just an 


G10 CLS 

1020 output_neurons=2 

1030 input_neurons=8 

1040 layers=2 

1650 iterations=500 

1060 DIM neuron_output(input_neurons, layers) 
1070 DIM neuron_weight(input_neurons, 
input_neurons+ | layers) 

1080 DIM delta(input_neurons, ayers) 

1090 LM inputs(input_neurons), 

netork output(input_neurons),target(input_ neurons) 
1100 setup_network_weights layers, mput_neurons 
1110 count=0 

1120 average _error=0 

1136 REPeat train_network loop 

1140 get_input input_neurons,output_neurons 
1150 run_network output_neurons,input_neurons, 
layers 

1160 train network output neurons,input neurons, 
layers,.7 ,neuron_error 

1170 count=count+] 

1180 show_results output_neurons,input_neurons, 
neuron_ error,count,average érror,] 

1190 IF count>=iterations THEN EXIT train_net 
work_loop 

1200 END REPeat train_network_loop 

1210: 

1220 REPeat get new data 

1230 CLS 

1240 PRINT "Press 1,1 or any otber key" 

1245 CLS 

1250 PRINT 

1260 key$=INKEYS(#9,-1) 

1270 key=CODE(key$) 

1280 SELect ON key 

1290 =49: RESTORE 1590 

13060 FOR 1=1 TO input_neurons 

1316 READ inputs(1) 

1320 END FOR i 

1330 run_network output_neurons,input_neu 
rons, layers 

1340 — show_results output_neurons,input_ne 
urons,neuron error,count,average error,0 

1350 =108 : RESTORE 1600 

1360 FOR!) TO input_neurons 

1370 READ inputs() 

1380) END FOR it 

1390 run network output _neurons,rnput_neu 
rons, layers 

14060 show_results output_neurons,input_ neu 
rons,heuron error,countaverage_error,0 

1410 =REMAINDER : 


1420 a=RND:b=RND:c=RND:d=RND:e=RND:fFRND: 


g=RND:b=RND 

1430 IF a>.5 THEN inpuis(1)=1: ELSE 
inputs(1j=0: END IF 

1440 if b>.5 THEN inputs(2)=1: ELSE 
mipuis(2)=0: END IF 

1450 IF c>.S THEN inputs(3)=1]: ELSE 
inputs(3)=0: END IF 

1460 IF d>.5 THEN mputs(4)=1: ELSE 
mputs(4)=0: END IF 

1470 «IF e>.5 THEN inputs(5)=1: ELSE 
inputs(5)=0: END IF 

1480s t>.5 THEN imputs(6)=1: ELSE 
imputs(6)=0: END IF 

1490s TF g>.5 THEN imputs(7)=1: ELSE 
inputs(7)=0: END IF 

1500 «IF h>.S THEN imputs(8)=1: ELSE 
inputs($)=0: END IF — 

1510 mun_network output_neurons,input neu 
rons, layers 

1520 show_results output_neurons,input_neu 


rons, 
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neuron_error,count,average_error,0 
1530 END SELect 
1540 PRINT 
1550 PRINT "Press any key to continue" 
1560 a$=INKEY$(#0,-1) 
-1570 CLS 
1580 END REPeat get_new_data 
1590 DATA 0,0,1,1,0,0,0,1 
1600 DATA 0,1,3,0,1,1,0,0 
1610: 


1620 DEFine PROCedure run_network(output neurons 


iuput_neurons, layers) 

1630 FOR i=! TO input_ neurons 

1640 e=neuron_weight(i,input_neurons+1,1) 
1650 FOR }=1 TO input_neurons 

1660 e=et+neuron_weighi(i,j,1)*inputs(j) 
1670 NEXT} 

1680 neuron outputli,1)=1/(1+EXP(-e)) 

1690 NEXT i 

1/00: 

1710 IF layers>1 TLHEN 

1720 FOR k=2 TO layers 

1730 FORi=1 TO input neurons 

1740 e=neuron_weight(i,input_neurons+1,k) 
1750. FOR j=1 TO input_neurons 

1760 e=e!neuron_weight(i,j,k)*neuron out 
putG,k-1) 

1770 NEXT} 

1780 neuron output(i,k)=1/(1+EXP(-e)) 
1790 NEXT? 

1800 NEXT k 

1810 END IF 

1820 : 

1830 FOR 1-1 TO output_neurons 

1840 netork_ ouiput(i)=neuron_output(i,layers) 
ISSO NEXT 1 

1860 END DEF ine nin_network 

1870 : 

1880 : 


1890 DEFine PROCedure get_input(input_ncurons, 
outpul neurons) 
1900 a=RND 


1910 IF a>=.5 THEN 

1920) RESTORE 2140 

1930 FOR i=1 TO input_neurons 
1940 READ inputs) 

1950 END FOR i 

1960 iarget(1)=1 

1970 target(2)=0 

1980 END [F 

1990 IF a<.5 THEN 

2000 RESTORE 2150 

2010 FOR i=1 TO input_neurons 
2020 READ inputs(i) 

2030 END FOR i 

2040 target(1)=0 

2050 target(2)=1 

2060 END IF 

2070 FOR 1 TO output neurons 
2080 IF target(Q=1 THEN 

2090 — targei(i)=.9 

2100 ELSE 

2110 target(i)=.1 

2120 END IF 

2130 END FOR i 

2140 DATA 0,1,1,0,1,1,0,0 > REMark |} 
2150 DATA 0,0,1,1,0,0,0,1 ; REMark 1 
2160 END DEF ine get_input 
2170: 

2180: 

2190 DEFine PROCedure setup_network_weights( 
input_neurons) 

2200 FOR k=1 TO layers 

2210 FOR 1 TO input_neurons 
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example and, for more general 
input the procedure ‘get_input’ 
could be altered to take training 
data from a file that contained 
scanned images for example. 


Conclusions 


After, all this you might be 
thinking ‘so what’, there are 
excellent routines for getting 
keyboard input and turning it 


into a character on the screen, 
but this misses the point This 
code has learnt to recognise the 
two characters by being pre- 
sented with examples, and so in 
principle it should be possible to 
extend the network so that it 
recognises more characters, 
and even characters from other 
sources, Such as a scanner, or a 
paint package. Perhaps you 
could try scanned images of the 


2220 FOR j=1 TO input_neurons+1 
2230 neuron weight(ij,=(RND-.5) 
2240 NEXT) 

2250 NEXTi 

2260 NEXT k 

2270 END DEF ine setup_network_weights 
2280: 

2290 : 


2300 DEF ine PROCedure show _results(output_neurons, 


input_neurous,neuron_error,count,average error, 
print target) ) 
2310 AT 0,0 
320 PRINT "A Simple Neural Network 
330 FOR i=1 TO imput_neurons 
340) PRINT "Input ";1,impuis(i) 
350 END FOR i 
2360 PRINT 
2370 LF pnnt_target=1 THEN 
2386 FOR i=1 TO output_neurons 
2390 PRINT "Target ";i;" ";target(i),"Result 
"s6" "“netork output(i) 
2400 END FOR i 
2416 PRINT 
2420 END IF 
2430 IF print_target=0 THEN 
2440 FOR i=1 TO output_neurons 
2450 PRINT “Result ";1;" "jnetork_output() 
2460 END FORi 
2470 PRINT 
2480 END IF 
2490 PRINT "Number of Itererations ";count 
2500 PRINT "Error this time ";neuron_error 
2510 average error=.2*neuron_error+.8* 
average error 
2520 PRINT "Smoothed error ";average_error; 


" " 


PNM MN KH ft 


2530 END DEFine show results 

254) - 

2550: 

2560 DEPine PROCedure train network(outpul eu 


rons, 
imput_neurons,layers,eta,neuron_error) 

2570 neuron_error=O 

2580 FOR i=1 TO input_neurons 

2590 IF 1<=output_neurons THEN 

2600 delta(i,layers)=(target(i)-netork_output 


\ (4))*netork_ouiput(i)*(1-netork_ouiput(i)) 


2610 neuron_errorneuron_error+(target()- 
netork_output(i))*(target(i)-netork output(i)) 
2620 ELSE 

2630 delia(i,layers)=0 

2640 END IF 

2650 NEXT: 

2660 FOR k=layers-! TO 1 STEP -1 

2676 FOR i=1 TO inpui_ neurons 

2680  deltasum=0 

2690 FOR j=! FO input_neurons 

2700 deltasum=déltasum4 deltay,k+ 1)* 
neuron. weight(j,i,k+1) 


letter ‘!’ and number °1' from 
source code printouts, as these 
are often difficult for humans to 
distinguish. 

Whatever you do, please 
experiment with the network 
and feel free to modify and use 
it wherever you can. The area of 
Al, and in particular that of neur- 
al networks, is really only just 
developing, so this is an area 
where individuals can make 
progress in the field. There are 
even some text books appear- 
ing, which any decent library will 
be able to order (see Looking 
for a Book?, Hardy Hints, QL 
World March 1993) and so it is 
relatively easy to ‘bootstrap’ 
yourself to the current state of 
understanding, and then you 
may be able to push forward 
the frontier of human knowl- 
edge. 
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710 NEXT j 
2720 delta(i,k)=neuron_output(,k)*(1- 


euron_output(i,k))*deltasum 


2730 NEXTi 

2740 NEXT k 

2750 FOR i=1 TO input_neurons 

2760 FOR }=1 TO input_neurons 

2770 neuron_weighi(i,j,1)=neuron_weightG,j,1)4 
ceta* delta(i,1)*inputs(j) 

2780 NEXT j 

2790 neuron weight(i,input_neuronst1,1)= 
neuron weight(i,input_neurons+],1)+eta*deltaGi,1) 
2800 NEXT 1 

2810: 


2820 ° 
2830 l’OR k=2 TO layers 
2840 FOR i=1 TO input_neurons 


2850 FOR j=? TO input_neurons 

2860 neuron_weight(ij,k)=neuron_weight(j,k)+ 
ela*delta(i.k)*neuron_outputtj,k-1) . 
2870 NEXT} 

2880 neuron_weight(i,imput_neurons+1,k)=neu 
ron_weighi(i,input_neurons+ 1,k)+eta*delta(i,k) 
2890 NEXT1 

2000 NEXT k 

2910 BND DEFine vain petwork 


Now available on a QL near you... 


GT-Prolog/QL 


Interactive Workbench (needs 512k) 
* Windows, Menus, Dialogues 
* Editor 
* Debugger 
User Guide, Reference Manual 
Full QDOS compatibility 
Configurable Memory up to 16Mb 


Edinburgh Syntax 

Incremental Compiler 

Automatic Garbage Collectors 
Tail-Recursion Optimisation 
First Argument Indexing/Hashing 
32bit integers / 48bit reals 

255 byte atoms / 32kb strings 


Turbo Performance - Naive Reverse exceeds 5k LIPS (GC) 
Price including postage/packing £89.95 


For more information contact us at 
Rosebank, Stream Road, 
Upton, Oxon, OX11 9JG 
Tel/Fax: 0235-851818 
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Proknub 
Toolbox 


Bryan Davies 
sizes up Digital 
Precision’s 
ProPub assis- 
tants. 


INFORMATION 
Program: Professional 
Publisher Toolbox | & Il 
Price: £29.95 each, 
£49.95 

for both 

Supplier: Digital Precision 
Ltd,, 222 The Avenue, 
Chingford, London 

E4 9SE. 

Tel. 081 527 5493, 


ProPub toolbox | 


was reviewed in early 1991, 
and is essentially the same 
now as then (including the 
price). It is worth looking at 
it again because the inter- 
est in DTP is, if anything, 
higher now than it was, 
and because there is a 
Toolbox II to go with it. 
Reviewers have an 
unending stream of new 
programs (and new ver- 
sions of existing programs) 


placed before them. It’s 
easy to forget that many 
users stick with the same 
program - maybe even the 
same version - for years. 
These users welcome ada- 
on programs, which extend 
the range their existing pro- 
grams without creating 
headaches. Learning new 
main programs usually 
means days or months of 
study, whereas add-on 
items can quickly be mas- 
tered. 

Both Toolboxes come on 
floppy disk only, and 
require a minimum 256 KB 
memory expansion. As 
ProPub itself requires a 
minimum 512 KB extra, the 
buyer of a Toolbox is 
almost certain to have a 
suitable system. 


Toolbox I 


There are two programs, 
a set of 44 founts, a collec- 
tion of 13 clip art images, 
and a few odd demonstra- 
tion graphics files on the 
disk. There is also a boot 
file and a SuperBasic 
extensions file. These two 
files will normally be incor- 
porated into the user’s 
ProPub boot file, as the 
boot is a one-liner which 
loads the extensions, and 
these are included in the 
Toolkit extensions file with 
ProPub (and in the Xtras 
file with The Editor). There 
is an UPDATES_DOC file, 
which is short and points 
out that some items noted 
in the instructions are no 
longer on the Toolbox | 
disk, but incorporated into 
Toolbox ll; in their place, 
there are extra clip art files. 

The founts all have the 
suffix _HDF, indicating that 
they are the better, high- 
definition type. The clip art 
files number thirteen and 
have the suffix _CUT, which 
will probably be familiar to 
regular DTP users. The 
other graphics files are an 
assortment of Digital 
Precisions’ own files, and 
have been seen elsewhere 
(such as with ProPub itself). 

The clip art files are not 
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sensational, but could be 
useful if you require illustra- 
tions of that type; various 
animal and country 
images, for instance. The 
founts are the better part of 
the disk, covering quite a 
wide range of styles. 

The programs are utilities 
- Grab_Sector_ClipArt and 
PrepText. Sector Software 
had a collection of clip art 
files, and Grab is designed 
to capture these images 
and put them into a form 
suitable for loading into 
ProPub: standard 32 KB 
screen dump _ format. 
PrepText is aimed at text 
created in a word-process- 
ing program, the obvious 
one here being Perfection. 
It puts text into a more suit- 
able shape for loading into 
ProPub; untreated text can 
show oddities after import. 
The text should be saved 
in Ascii form - that is, with- 
out the formatting informa- 
tion used by the word-pro- 
cessing program. PrepText 
keeps basically the same 
format but makes changes 
to maintain the correct line 
format. 


Toolbox Ii 


The instructions for 
Toolbox | were stated to be 
the “shortest manual” DP 
has issued - one page. 
Toolbox Il has two pages 
so, by DP standards, it too 
is short. This second disk 
contains 38 more _HDF 
founts, 6 _QLS founts 
(which are not of quite the 
same high quality), and 4 
_FND founts. There are 
three utility programs - 
PPCompressor, PPPSaver 
and QWConverter. 

PPCompressor is a 
space-saver for ProPub 
page files. The stated size 
range for standard page 
files is 28,800 to 320,000 
bytes, and it is easy to fill a 
few disks. Apart from com- 
pressing the files, this pro- 
gram can put them onto 
another device, thereby 
performing a back-up func- 
tion. As ProPub cannot 
load compressed files, 


PPCompressor has an 
expand function, too. 

A sample compressed 
file is supplied, and the 
user can expand it with 
PPCompressor and check 
it with PPPSaver. This pro- 
gram enables part of a 
ProPub page to be saved, 
for use in graphics pro- 
grams or with SuperBasic. 

The third program gets 
its name from Qwriter ll. 
Founts from that program 
can be converted to 
ProPub _HDF form by 
QWConverter; they can 
also be enlarged with 
another DP program, Font 
Enlarger. The fount files 
must have the suffix _FND, 
but Qwriter Il itself has a 
converter, to change _FNT 
files to _FND. 

All three programs can 
be either EXEC-ed or 
loaded as SuperBasic 
extensions. In the second 
case, they are activated 
simply by typing (for exam- 
ple) PPCOMP ENTER. That 
is, the file PPCOMPRES- 
SOR can be handled in 
these ways: 


EXEC_W “flo1_PPCOM- 
PRESSOR’ 


or 


base=RESPR(50*51 2):LB 
YTES “flp1_PPCOMPRES- 
SOR’ base:CALL base 


Minerva users can run 
these programs on the 
second screen. 


In Use 


One of the standard 
sample files with ProPub is 
called DEMO_PAGE, and 
its normal size is 96018. 
After treatment with 
PPCompressor, the size 
dropped to 50582 bytes, 
roughly 53% of the initial 
size. The compression 
operation took one sec- 
ond! Expanding the com- 
pressed file brought it back 
to its full size, in slightly 
longer time. The program 
misleadingly stated that the 
operation had been a fur- 


” 


ther “compress”; in fact, try- 
ing a further compression 
operation produced no 
change in file size, so the 
initial pass looks to be fully 
effective. 

The expanded file was 
looked at with PPPSaver. It 
came up on the screen 
quickly and correctly, but 
without the menu that the 
instructions state should 
be displayed. That created 
no problem, as you can fol- 
low the written instructions 
for positioning the page, 
then press Space to indi- 
cate that you have selected 
the area you want. The pro- 
gram creates 32 KB files, 
and that clearly means you 
can select only a full 
screen for saving. The save 
process took a second or 
two. Escaping from the pro- 
gram was not a clean 
process, as the image of 
the expanded page stayed 
on the screen. 

Both the compressed 
and expanded page, and 
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COLLEGTIOIN 


Now you can keep your Sinclair QL 
lat eae safe and clean. No 
more dog-eared covers or missing 
copies . . . You can protect your 
magazines in this high auslh ; 
specially-created binder. This Sinclair 
QL World binder will comfortably hold 
a complete year’s issues of your 
favourite Sinclair magazine. It is a high 
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I Please send me [_] QL World binders — | enclose £6.95 for each binder including VAT. postage & packing. 
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the saved part of that page, 
loaded into ProPub proper- 
ly. DTP is space-hungry. If 
you can save space of this 
order, it will save you 
money in disk costs; files 
you value should have at 
least one back-up copy, so 
the saving is two-fold. 


Conclusion 


With programs such as 
these there is no question 
of comparing them with 
competitive products and 
deciding which is the best 
to buy. For the most part, 
there is no third-party com- 
petition in the QL world. If 
you are a serious ProPub 
user, there will be some- 
thing of interest here, and it 
is simply a question of 
whether or not your budget 
runs to the purchase price 
at the time. We are into the 
Christmas season now, 
and you might use a few 
extra founts to decorate the 
tree... 
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FILE HANDLING TRANS24 (U) snseorssrsvunssensones for disks or disk box divider sets 


FILES 2 Wouu. HARDWARE 

4MATTER & LOCKSMITHE . MICRO PROCESS ©o TROL ~ ll a ee 
MPC SOFIWARE.... eae TEXT .... 
NETWORK PROVER .. femeernenes 
QPOWER REGULATOR ..... QUICK POSTERS (U.... 
(unsuitable Gold Card) ROB ROY PACK (U) . 


VOICE ANALYSER-New! 


Ask for details and price TEXTIDY. ccovsssscctsscoscsen / 
J Add £2 50 postage for MPC, TEXTN’ GRAPHIX | sscinstssvcsisstvtscsbessssessusesteossd enone 20100 
£30.00 SERMOUSE AND VOICE ANALYSER 

OPD INTERCHANGE. £15.00 OTHER SOFTWARE 
QL-PC FILESERVER .... £24.50 MAGAZINES HOME BUDGET (WU) .... 
STOOL. ccc ‘i OREVIEW jexevctircscectes stores 

QL TECHNICAL REVIEW .. 

issues 1-8 available ove 

QL ADVENTURER'S FORUM tsssssssssssosssssrsssvnsesnees £1.75 THE Pointer Environment package! 
GAMES & LEISURE Issues 1-9 available OTOP cence £29.95 
FIVE GAME PACK (U) £12. QL LEISURE REVIEW csinaussnennnnsnnnnanani £2.00 SCREEN DAZZLER 
FLEET TACTICAL COMMAND (U) £39.95 issues 1-2 available 
FIC DATA PRINTER... £9.95 (UK prices only shown) pac A amas 


FLIGHTDECK (U) ... SLOWGOLD (U)..... 


“£10. VISION MIXER 1 . 
EASYPTR 3 PART I. £40.50 VISION MIXER PLUS .. 


QUESTION MASTER (U) 
QUIZ MASTER 2 (U)... 
RETURN TO EDEN 


SOLITUDE (U) «sve EASYPTR 3 PART 3 ... £20.00 CALL OR WRITE FOR A FREE COPY OF 

SQUIDGY ROUND THE WORLD (U) MEGATOOLKIT DISK (U) ... w£25,00 OUR QL SOFTWARE CATALOGUE 
MEGATOOLKIT EPROM (U) .. £40.00 DETAILING AROUND 100 QL PRODUCTS 
QLIBERATOR 3 36  sevsssosser: 

LABELLING BUDGET QLIBERATOR (U) .... PLEASE NOTE: (U) ABOVE MEANS THAT 

ADDRESS BOOK&LABEL PRINTER .... a QLOAD AND QREF (U) ...... THE SOFTWARE IS SUITABLE FOR USE 

SUPER DISK LABELLER S EDIT EDITOR  eseoseossesssee 


ON A 128K QL 


society, Eurocheque, Postal Order, cash (send by registered pos) or by credit card - Visa, Access, Mastercard and Eurocard accepted Please make cheques 
etc payable to DILWYN JONES COMPUTING Minimum order value £5 00 (due to bank charges) Goods remain property of Dilwyn Jones Computing 

until paid for in full Orders normally sent out within a few days of receipt, we will attempt to advise Uf any delay anticipated due to stock problems Orders 

can be accepted by telephone if paid for with credit card Orders paid with credit card can only be sent to cardholder's address under card company rules 

FAX - We now have a Fax machine on our usual number (0248) 354023 


TERMS: POSTAGE-software sert post free to UK, overseas add £1 00 per program (maximum £3 00) Floppy disks, SERmouse, etc add £2 50 postage (see 
above) PAYMENT - IN UK currency (pounds sterling) only, please Valid methods of payment are cheque drawn on UK branch of bank or building 


